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PREFACE 


This manual deocuments On-Line Performance Tool OPT/3000, a software performance measurement 
tool designed for use in an interactive environment on an HP 3000 System operating under MPE IV or 
later. . 


OPT/3000 allows you to investigate both existing and potential causes of performance-related problems 
on your system by monitoring the systems workload, memory and CPU usage, I/O traffic, and table 
utilization. Proper interpretation of the results of your investigation will help you implement necessary 
changes to your system to improve its performance. 


This manual describes how to operate the OPT/3000 facility. It discusses the hardware and software 
requirements for running OPT/3000, provides directions on how to get from one display to another, and 
explains what each display means. 


OPT/3000 is a powerful software performance tool that aids the trained user in improving and enhancing 
the performance of the HP 3000. Correct interpretation of the displays generated by OPT/3000 requires 
an understanding of the internal operation of the MPE Operating System. It is highly recommended that 
the potential user take the System Performance Analysis class in conjunction with reading this manual. 
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NOTATION 


nonitalics 


ttalics 


C ] 


{ } 


DESCRIPTION 

Words in syntax statements which are not in italics must be entered exactly as 
shown. Punctuation characters other than brackets, braces and ellipses must also be 
entered exactly as shown. For example: 


EXIT; 


Words in syntax statements which are in italics denote a parameter which must be 
replaced by a user-supplied variable. For example: 


CLOSE filename 


An element inside brackets in a syntax statement is optional. Several elements 


Stacked inside brackets means the user may select any one or none of these elements. 


For example: 
[al User may select A or B or neither. 


When several elements are stacked within braces in a syntax statement, the user must 
select one of those elements. For example: 


A 
B User must select A or B or C. 
C 


A horizontal ellipsis in a syntax statement indicates that a previous element may be 
repeated. For example: 


[,itemname]...3 


In addition, vertical and horizontal ellipses may be used in examples to indicate that 
portions of the example have been omitted. 


A shaded delimiter preceding a parameter in a syntax statement indicates that the 
delimiter must be supplied whenever (a) that parameter is included or (b) that 
parameter is omitted and any other parameter which follows is included. For 
example: 


means that the following are allowed: 


itema 

ttema,itemb 
ittema,itemb,iteme 
itema,,iteme 
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underlining 





— 


CONTROLJcHar 


When necessary for clarity, the symbol A may be used in a syntax Statement to 
indicate a required blank or an exact number of blanks. For example: 


SET [ (modifier) ]A(variable) ; 


When necessary for clarity in an example, user input may be underlined. For 
example: 


NEW NAME? ALPHA 


In addition, brackets, braces or ellipses appearing in syntax or format statements 
which must be entered as shown will be underlined. For example: 


LET var[[subseript]] = value 


Shading represents inverse video on the terminal’s screen. In addition, it is used to 
emphasize key portions of an example. 


The symbol (____) may be used to indicate a key on the terminal’s keyboard. For 
example, indicates the carriage return key. 


Control characters are indicated by followed by the character. For example, 
(CONTROL)Y means the user presses the control key and the character Y simultaneously. 
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SECTION 


INTRODUCTION TO OPT/3000 





ON-LINE PERFORMANCE TOOL (OPT/3000) is the user’s window into the system and allows 
monitoring of system workload, memory and CPU usage, I/O traffic, and table utilization. By viewing the 
activity in detail, you can modify your present system to improve performance and more efficiently 
design new applications. 


FEATURES OF OPT/3000 


OPT/3000 is designed to run on version IV, or later versions of the MPE Operating System. The features 
that enhance OPT/3000 are listed below. 


Interactive Reporting 


OPT/3000 is an interactive software tool that reports performance-related data. in the form of 
dynamically updated video displays and allows you to control the display-update time interval. Once the 
sampling interval is set, the display will be updated automatically. In addition, a display can be updated 
between specified intervals by pressing the key. Where practical, the information reported by 
OPT/3000 is presented in graphic format. The video enhancements and line drawing character sets are 
available on the terminals that support this feature. 


Multiple Display Levels 

System resource information is grouped into contexts. Displays contained within a particular context are 
"layered" such that each level provides more detailed information than the previous level. 

Simple and Flexible User Interface 

Running OPT/3000 requires minimal interaction on your part. All commands consist of a single 
keyboard character, and you are automatically prompted if any additional information is required. A 
menu of available commands can be displayed at any time and defaults are provided within each context. 
Hard Copy Capability 

A hard copy of each display can be generated on a line printer. Hard copies include all information from 
the interactive displays, but video enhancements and the line drawing character set are represented 


differently on the hard copy. In some cases, additional information is provided in the hard copy that 
cannot be displayed interactively due to space limitations on the terminal screen. 
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Periodic Summary Reporting of Resource Usage 

In addition to interactive reporting of performance-related information, OPT/3000 can generate hard 
copy summary reports of resource usage at regular intervals. The length of the interval is specified by the 
user. These reports can be used to detect trends in resource usage as well as to determine periods of peak 
demands on your system. 

Internal Documentation Facility 

OPT/3000 provides a fully integrated HELP facility with multiple levels of documentation. Using this 
facility, you can obtain on-line documentation on general information or details specific to the current 


context. The documentation includes short descriptions, and where appropriate, legend and interpretation 
guidelines. 


Log File 


The information used to generate the summary report can also be written to a disc file. The information 
is in the form of summary records. This file is provided to enable the extension of the OPT/3000 
reporting capabilities. 


Percentage Bars 


OPT/3000 displays some data as percentage bars. 


l=2 
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OPT/3000 will operate on any HP system operating under MPE IV or later revisions. 
TERMINALS 


In order to fully utilize all display features of OPT/3000, an HP terminal with the following capabilities 
must be used: ji 


e Line drawing character set. 

e All video enhancements, (inverse video, half-bright, underline, and blinking) 

e Upper and lowercase character sets. 

e A minimum of 8K of display memory (12K for a system with more than 2 MB of memory) 

For all supported terminals, with the exception of the 2640B and 2644, OPT/3000 will automatically set 


the terminal straps and latching keys and return them to their original settings when you exit the 
program. 


NOTE 


Straps G and H need to be set correctly to read the terminal status. If it is 
necessary for OPT/3000 to alter them, they will not be restored to their 
original settings. OPT/3000 will leave the G strap OPEN and the H strap 
CLOSED if you are using a terminal type 11. If a terminal type 10 is in 
use, both the G and H straps will be left CLOSED. 


If you are using a 2640B or 2644 terminal, you must set the terminal straps to conform with the 
requirements of OPT/3000 in the following way: 


Strap B CLOSED Strap G CLOSED 


Strap C OPEN Strap H CLOSED 
Strap D CLOSED 
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In addition, the Latching Keys should be set as follows: 


Block Mode UP 
Auto Lf UP 
Memory Lock UP 


OPT/3000 will NOT reset the terminal straps on the 2640B or 2644 because these terminals do not allow 
programmatic setting of the straps. When Memory Lock is in effect, the Home-up operation of the 
2640B and 2644 will not operate in the same fashion as a 2645, 2647, or 2648, causing two of 
OPT/3000’s displays to appear improperly. 


If the line drawing character set of your terminal is not in position B, OPT/3000’s Control Operation 
command (#A) allows you to inform OPT/3000 of the actual position of the line drawing character set. 


You must log on to the system with terminal type 10, 11, or 14 as terminal type created by workstation 
configuration, for OPT/3000 to perform correctly. If you log on with terminal type "11", OPT/3000 will 
change it to type "10" during execution, then return the terminal type to "11" upon termination. If 
terminal type 11 is in use, OPT/3000 will leave the G strap OPEN and the H strap CLOSED. If type "10" 
is in use, both the G and H straps will be left CLOSED. 


Execution of OPT/ 3000 is permissible on both point-to-point and multipoint terminals. Users of 
multipoint terminals, however, should use a Terminal Type 14, OPT/3000 will recognize type "14" and 
not change it. Generation of hard copy is severely limited on multipoint terminals. 

Line Printer 

A line printer is necessary if you wish to use the hard copy capability of OPT/3000. A printer with 
lowercase characters is necessary for some displays to be completely described. Two files are generated by 
OPT/3000 for report purposes - OPTREPT for summary reports and OPTLIST for hard copy displays. 
Operating System 


OPT/3000 is designed to run on version IV or later of the MPE Operating System as a user program with 
Privileged Mode and Data Segment Capabilities. 


The BREAK option is disabled during the execution of OPT/3000. You can, however, execute MPE 


commands within OPT/3000 by using the MPE Display Control command. This will be discussed in 
Section 3. 


22 


Specifications for Running OPT/3000 


Recoverability 


OPT/3000 can create three different output files. Two of these, OPTREPT and OPTLIST, are spooled 
printer files. OPTREPT contains the summary reports produced either from a batch job or interactively 
from the Global Context. OPTLIST contains reproductions of the various screens produced by OPT/3000 
interactively. The third file is the Summary Log file. This file is produced by the summary se van 
or interactively), and is written to a standard discfile. 


In the event of a system failure, the output generated from OPT/3000 can be left in various states. 

Open spoolfiles will be lost if the normal system functions are interrupted. Closed spoolfiles can be 
recovered if the system is restored to normal operations with a WARMSTART. If a WARMSTART is not 
used to restart the system, all spoolfiles not yet printed will be lost. 

It is possible to recover all data written to a log file prior to the last summary report generated. The 


information for the most recent summary report may also be recovered unless the actual generation of the 
summary report is in progress when the failure occurs. 
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OVERVIEW OF OPERATIONS 


Figure 2-1, the Command Structure Diagram, summarizes the operation of OPT/3000. Note that the 
Memory Context has additional commands that further break down its histogram displays. For example, 
when looking at the existing code segments being used, you may wish to compare the code segments 
belonging only to the system (non-user segments (N)) with those segments belonging only to the user (User 
Segments (U)). 


Context Concept 


OPT/3000 presents system information in the form of display contexts. There is a context for each of the 
system resources that OPT/3000 monitors and each context determines the commands and displays that 
are available. In turn, each context is divided into displays that define in graphic form (such as bar charts 
and histograms) the resource that it is associated with. 


For example, there is an I/O Context that is divided into disc, printer, and tape activities. In addition, 
displays may have additional commands that perform a certain function or that break the display down 
into more detail. 


Command Syntax 


All OPT/3000 commands consist of a single keyboard character. Lowercase alphabetic characters are 
shifted to their uppercase equivalents. A character with no meaning in the current display context will be 
treated as a (RETURN). Pressing simply updates the current display. 


If you type a control character that has no special meaning to MPE, it is also be treated as a (RETURN). See 
the MPE Commands Manual (32033-90006) for a list of ASCII Control Characters which have special 
meanings within MPE. 


Commands are accepted when OPT/3000 has completed generating the present display on the terminal 
and the cursor is at the bottom of the screen. At that time, you can change contexts, displays, or update 
the current display by pressing (RETURN). 


The same command may have different meanings in different contexts. For example, using the command 
"D" while in the I/O Context displays disc activity; using "D' under the Tables Context displays detailed 
table usage. See Figure 2-1, Command Structure Diagram. 


There are three categories of commands used in OPT/3000: 


e Display Control - These are "global" commands that have general system applications such as 
~ OPT/3000’s HELP facility. They are accessible from any context. 


e Control Operation - These commands allow you to access contexts and perform other special 
operations such as closing the hard copy listing file. They are accessible from all contexts by entering 
a pound sign (#) in association with a character. (e.g., "#P") 


e Context - These commands access graphic displays of the current context’s resources such as disc, 
printer or tape activities in the I/O Context. Context Commands are only accessible within their own 
specific context (i.e., displays of disc or printer activity are only available when you have accessed the 
I/O Context). 
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Figure 2-1. OPT/3000 Command Structure Diagram 


If you are asked a YES or NO question, there are five valid responses: 


(RETURN), Y, N, YES, and NO. is interpreted as YES. 
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EXECUTING OPT/3000 


OPT/ 3000 is invoked by using the MPE RUN Command: 


:RUN OPT.PUB.SYS 


Batch Access 


Execution of OPT/3000 in Batch Mode is permissible, but periodic generation of global statistic summary 
reports and detailed table information reports are the only obtainable output. The default is generation 
of global statistics only. The user can use the PARM option on the RUN command. The parm values are 
as follows: 


PARM = 0 --> Global Statistics (Def.) 
PARM = 1 --> Detailed Table Statistics 
PARM = 2 --> Both of the above 


When OPT/3000 is run in BATCH MODE, OPT/3000 will read responses to the following five questions 
from the file $STDIN: 


DEFAULT 
MINUTES BETWEEN SUMMARY REPORTS? . (60) 
REPORTS BETWEEN CLOSING OF REPORT FILE? ( 8) 
FILE CLOSINGS BEFORE TERMINATION? | ( 3) 
NAME OF LOG FILE? (none) 
SUMMARY REPORT IDENTIFICATION (MAX OF 50 CHARS) (none) 


Responses to the first three questions must be positive integers. If not, the error message: 
### INPUT MUST BE A POSITIVE INTEGER ### 
appears and OPT/3000 aborts with Fatal Error 100. 
If you supply a non-blank name in response to the fourth question, OPT/3000 will use this input as the 
name of the log file. If the log file specified already exists, the old copy is automatically purged. The 


default is that no log file is created. 


Your response to the last question is a label that appears on each of the summary reports. It can be a 
maximum of 50 characters. Responses to all of the above questions are echoed to the file $STDLIST. 


If an end-of-file is encountered, default values will be assumed for all remaining parameters. If a blank 


line or is entered for a specific parameter, the default value will be assumed for that parameter 
only. 
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If a non-default value is supplied for any of the above questions, a value or blank line must also be 
supplied for all inputs prior to the desired non-default value. For example, if you wish to input 2 as the 
response to the third question, you must also supply values (or blank lines) for the first two questions. 
OPT/3000 creates a permanent log file and a report file. The report file is a spoolfile. 


For an example of a BATCH JOB FILE, see Appendix D. 


For a discussion of summary report generation, see Global Context in Section 5. 


interactive Access 


After logging on, OPT/3000 displays a header message and verifies that the terminal is appropriately 
configured. Typically, successful logon and terminal configuration automatically generate the default 
display in the Global Context. If you want a default context other than the Global Context, use the PARM 
parameter to specify the initial context. The PARM values and the corresponding contexts are: 

PARM 0 Global Context (default) 
1 Memory Context 
2 CPU/MM Context 
3 I/O Context 
4 Process Context 
5 Tables Context 


You can then change the context itself or the displays within a context until you are ready to terminate 
execution of OPT/ 3000. 


You can generate any display within the current context by entering the appropriate Context Command 
whenever commands are being accepted. The one exception is the Process Context where certain displays 
can be accessed only after generation of certain other displays. For example, in order to generate the 
Program File Users display in the Process Context, it is first necessary to generate the Program File 
Display. To generate a display in a non-current context, the appropriate Control Operation command is 
entered to get into the new context, so that the desired display within that new context can be specified. 


Once you have selected a display within a context, that display is automatically and repeatedly updated at 
the sampling interval you have set. The display can also be updated by entering a whenever 
commands are being accepted. Whenever a new display is generated, the old contents of the terminal 
screen are cleared. 


Data for the displays is obtained internally in two ways. Some information is gathered directly from MPE 
operating system tables and data structures, while the remainder is obtained from instrumentation 
embedded within MPE. The instrumentation updates a set of counters maintained in an extra data 
segment created for OPT/3000. These counters are accessed by OPT/3000 whenever any display is 
generated or updated, whether or not the counters are required for the display. 
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If the time interval between samples is too long, it is possible for many of OPT/3000’s counters to "wrap 
around" between successive samples of the instrumentation, causing OPT/3000 to report erroneous 
information. Therefore, the following warning message is displayed if the nverval between samples 
exceeds the approximate threshold value of 15 minutes: 





Normal execution of OPT/3000 will resume as soon as a is entered. 


Terminating OPT/3000 


To terminate OPT/3000 interactively, enter the Exit Command (£), which is a Display Control 
Command. The Control-Y trap mechanism of MPE also terminates interactive execution of OPT/3000. 
You will be prompted with: 


CONTINUE EXECUTION? (YES/NO) 


When you answer "NO", ont 3000 terminates execution. OPT/ 3000 terminates automatically if executed 
in batch mode. 


SECTION 


sei 
OPERATION COMMANDS | 3 | 


DISPLAY CONTROL AND CONTROL 





DISPLAY CONTROL COMMANDS 


Display Control and Control Operation Commands are available from anywhere within OPT/3000, and 
may be entered whenever OPT/3000 is accepting commands. Unlike Context Commands, whose meaning. 
is dependent on the current context, Display Control Commands and Control Operation Commands 
maintain a unique meaning regardless of the current context. 
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Figure 3-1. Display Control Commands 


Display Control Commands access a set of auxiliary operations and are available from any display when 
OPT/3000 is accepting commands. Display Control Commands are: 


Exit command 

Help command 

Listing command 

Time Change command | 
XEQ command 

MPE command 

Menu Display command 
! Note command 
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Exit Command (E) 


The Exit command is used to terminate execution of OPT/3000. After entering "E", you are prompted 
with: 


CONTINUE EXECUTION? (YES/NO) 
If you respond "NO", OPT/3000: 
e Turns on your terminal’s echo, executes an automatic carriage return/line-feed, and restores any 
altered terminal straps and latching keys to their original settings. Remember, OPT/3000 cannot 


restore G and H straps if they were altered. 


e Attempts to close the OPTREPT file. If the file is open, OPT/3000 will print the following message 
when the file is closed: 





e Attempts to close the OPTLIST file. If the file is open, OPT/3000 will print the following message 
when the file is closed: 





e Terminates execution of OPT/3000. © 


If your reply is "YES", OPT/3000 updates the current display, continuing as if the Exit command had not 
been entered. 


OPT/3000 can be exited only by using the Exit command or by using a Control-Y interrupt. Control-Y 
is not recognized during the generation or updating of a display. Control-Y or E must be entered between 


display updates when the program is accepting commands. The Control-Y interrupt generates the same 
prompt that is generated by the E command. 


Help Command (H) 


This command allows access to online documentation for OPT/3000. The documentation is divided into 
seven categories, from general to specific, each with multiple levels of explanation. 


When you enter "H", the following is displayed: 


INDICATE WHICH TYPE OF INFORMATION YOU DESIRE 


1. An explanation of the current display 

2. General information about the current context 

3. Information about a specific command in the current context 
4. Information about a specific context 

a: Information about control operation commands 

6. Information about display control commands 
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7. General information about OPT/3000 
OPT/3000 will then prompt with: 
TYPE? 


Entering any one of the seven digits (1 through 7) produces the appropriate documentation. When you 
press (RETURN), OPT/3000 displays and ee updates the current screen. Any other input causes 
the question to be repeated. 


For example, if you enter "4" (Information about a specific context), OPT/3000 prompts you with: 
ENTER CONTEXT: 


If any character other than a valid Context Command is typed, an error message appears. The error 
message contains a list of valid answers; in this case G, M, C, I, P, or T. The error message appears 
as follows: 


"Z’ IS NOT A VALID CONTEXT 
VALID CONTEXTS ARE G, M, C, I, P, T 


The error message and the prompt are repeated until a valid response is entered. In the help section, 
is not a valid response to this prompt. 


Entering "3" for assistance (a specific command within the current context) produces the prompt: 
ENTER COMMAND: 


Any currently valid command character can be typed at this time. Entering an invalid character, or a 
character that is valid only in another context, will generate the error message and a list of currently 
valid command characters. In this example, a "Y" was entered. 


‘Y’ IS NOT A VALID COMMAND IN THIS CONTEXT 
VALID COMMANDS. ARE c1,c2 ...... yen 


where cl,c2,..,cn is the list of valid commands for this prompt. OPT/3000 repeats the error message and 
the prompt until a legal character is typed. (RETURN) is not a valid response to this prompt. When a valid 
command is entered, the appropriate documentation will be displayed. 
You can respond to this prompt with a pound sign (#) if you want information about a Control Operation 
command. This input produces a second prompt. Any Control Operation command character produces 
the appropriate documentation. This prompt is: 

ENTER CHARACTER FOR CONTROL OPERATION COMMAND 


If you respond with an invalid Control Operation command, you will receive the message: 


“"Y’ IS NOT A VALID CONTROL OPERATION COMMAND 
VALID COMMANDS ARE A,C,G,H,1I,L,M,P,S,1T,? 


As with the other prompts in the help section, this prompt is repeated until you enter a valid Control 
Operation command, and is not valid. 
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When you have indicated the type of assistance desired, and have entered a valid response, OPT/3000 will 
begin to display the requested documentation. This documentation is divided into sections where 
practical. You are given the choice of continuing or stopping at the end of each section, or after each 
screen is filled, via the prompt: 

CONTINUE? (YES/NO) 
If you enter "YES" or (RETURN), an additional section of documentation is displayed. This prompt will 
appear at the end of each additional section except for the last. At any of these prompts, you may stop 
the documentation by entering "NO". 


When all sections of documentation have been displayed or you have stopped the display of that section, 
you may request further documentation or return to the current screen display. OPT/3000 will ask: 


DO YOU WISH INFORMATION ON ANOTHER SUBJECT? (YES/NO) 


Entering "YES" or (RETURN), will again display the seven types of information available, and the above 
dialog will be repeated. 


"NO" clears the terminal screen and regenerates the current display. 


Listing Command (L) 


The Listing command generates a hard copy of the current display. This command attempts to duplicate 
the terminal displays onto paper, but some reformatting is done to compensate for the lack of video 
enhancements. 

Each hard copy display heading includes: 

e Name of the display 

e The version number of OPT/3000 used 

e A copyright notice 

e The date and time at which the display data was collected 

e User specified label (maximum of 25 characters) 

e A page number 

Hard copies are generated to the file OPTLIST. This file is automatically opened by OPT/3000 when the 
first hard copy is requested. OPTLIST remains open until it is explicitly closed by the Close Listing File 
command (#L) or is implicitly closed by exiting OPT/3000. If you use the Close Listing File command 


(#L), a subsequent request for hard copy causes the file to be opened again. Page numbers are not reset if 
the file is opened more than once during one execution of OPT/3000. 
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When the file OPTLIST is opened, you are prompted with the following: 


ENTER HARD COPY IDENTIFICATION (max of 50 chars) 
> 


You can then enter up to 50 characters which will appear on the heading line of each hard copy. If the 
listing file is closed by using the Close Listing File command, you will be prompted for a new heading the 
next time a hard copy is requested. 
OPTLIST is opened with a default device class of LP. If a line printer with lowercase characters is 
available, a file equation should be used to direct the file to that device to enable more complete 
descriptions of some displays. If OPT/3000 is unable to open OPTLIST, the message: 

UNABLE TO OPEN FILE “’OPTLIST’ 


is displayed along with the file system error message and no hard copy is generated. 


While hard copy generation is in progress, the message: 





is displayed at the terminal. When hard copy generation is finished, this message is replaced by: 
GENERATION OF HARD COPY COMPLETE 


OPT/ 3000 then pauses for approximately three seconds, erases the message, and updates the current 
display. 


In order to generate hard copy for some displays, OPT/3000 must actually read the current contents of 
the screen. If this is not possible due to the terminal type or strap settings, the message: 





is displayed and no hard copy is generated. 


Time Change Command (T) 

This command allows you to change the delay interval between display updates. This time interval is the 
number of seconds between the completion of one display and the beginning of the next. When the Time 
Change command (T) is entered, you will receive the prompt: 


ENTER THE DELAY BETWEEN DISPLAYS? (CURRENT= 15, MAX=900 SECONDS) 


The display interval must be between 1 and 900 seconds (15 minutes). If the interval is not within these 
bounds, you receive the message: 


DELAY MUST BE BETWEEN 1 AND 900 SECONDS 
and the prompt is repeated. 


If you press (RETURN), OPT/3000 assumes the default of 15 seconds. Once you have specified a valid delay 
interval, the above dialogue is erased from the terminal screen and the current display is updated. 
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The current interval is the display interval plus some overhead due to OPT and the MPE instrumentation. 
The overhead is usually about 1.5 seconds. When the current interval is displayed, it includes this 
overhead. 


XEQ Command (X) | 


The XEQ command lets you specify a sequence of commands of up to 50 characters. This sequence 
becomes the source of commands for OPT/3000. OPT/3000 continually executes this sequence until 
another XEQ (X) command is entered. 


You enter your command sequence at the following prompt: 
ENTER SEQUENCE OF COMMANDS TO BE EXECUTED 


OPT/3000 interprets each character in the command string. After each command is interpreted, 
OPT/3000 pauses for the predefined time interval before acting on the next command. When the end of 
the string is reached, OPT/3000 restarts at the beginning of the string. 


If an illegal character is entered after a pound sign (#4), OPT/3000 prompts you for a valid command 
character. Any other time an illegal character is found, the current display is simply updated. Therefore, 
in some cases, an illegal command can be used to refresh the current display. When a valid command is 
found, OPT/3000 takes the appropriate action. 


Any OPT/3000 command can be included in the character sequence. Commands that require a response, 
however, produce a prompt on the screen and wait for a response. The execution of the XEQ command 
string will be suspended, and there will be no display updates until the prompt has been satisfied. 


There are two responses that can be included within the XEQ command sequence. The first is the 
response that satisfies the question produced by entering a new context. The second is the response to the 
question generated by entering the Bank Contents Display in the Memory Context. 


There are five contexts that offer a choice of which display to produce upon entering that context. These 
contexts are: CPU-Memory Manager, I/O, Memory, System Tables and Process. When one of these 
contexts is entered, a Context command can be included in the sequence to specify which display to 
produce. A space produces the default display. 


When entering the Bank Contents Display in the Memory Context, OPT/ 3000 asks for the number of the 
bank to be displayed. This bank number can be included in the XEQ command string. The bank number 
is a two digit octal number which is zero relative. If the Bank Contents Display command (B) is used, and 
it is not followed by two octal digits, OPT/3000 prompts for the bank number. 


Any character can appear in an XEQ command string. The current display is updated when a character is 
not identified as a Display Control, Control Operation, or Context command. 


For example, assume that the following string is entered: 


#M MO#C #1 L#PF#TDL¥GRL 
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The following would occur: 


Memory Context entered (#M) 

Memory Report Display generated () 

Memory Contents Display generated (M) 

Overall Histogram Display generated (0) 

CPU-Memory Manager Context entered (#C) 
CPU-Memory Management Report Display generated () 
CPU-Memory Management Report Display updated () 
I/O Context entered (#1) 


I/O Activity Report Display generated () 


Hard copy generated for current display (L) (Note that you are asked to enter hard copy 
identification if the listing file is not already open). 


Process Context entered (#P) 

Program File Display displayed (F) 

System Tables Context entered (#7) 

Detailed Table Use Display generated (D) 
Produce Hard Copy of Detailed Table Display (L) 


Global Context entered (#G) (The Global Resource Usage Report is automatically generated after 
entering the Global Context) 


Single Summary Report generated (R) 


Hard copy generated for current display (L) 


The XEQ string commands are executed at the interval defined by the Time Change command (T). By 
simply entering (RETURN), you can execute the next command in the sequence without waiting for the 
entire delay interval. 


The string will be re-executed until another XEQ (X) command is found. An "X" can be located in the 
command string or entered from the terminal. Pressing at the XEQ prompt terminates XEQ 
control, OPT/3000 returns to its normal mode of operation and the XEQ sequence will no longer be 
defined. 
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MPE Command (:) 


This command enables you to enter any MPE command which can be programmatically invoked via the 
COMMAND intrinsic. When the command ":" is entered, you are prompted with: 


ENTER MPE COMMAND BELOW (<CR> to return to display) 


Now you may enter an MPE command. If the command is executed with no errors, the message: 





AY BE UNDEFINED. COMMAND 


is displayed. If an error was detected in the command, the message: 





is displayed and the appropriate CI error message is generated. After one of the above three messages is 
displayed, OPT/3000 repeats the initial prompt. At this point you may enter another MPE command or 
simply press to return to the current display. In the second case, OPT/3000 will erase the above 
dialogue (including any output generated by the MPE Commands) and then generate the current display). 


Menu Display Command (7?) 
This command generates a list of commands that are available in the current display context. When space 
permits, a brief set of instructions also appears. Once the menu appears, you are prompted for a 


command. If you enter an invalid command or a (RETURN), the default display for the context is generated. 


Note that if you request a hard copy at this point, you obtain a hard copy of the default of the current 
context. Any erroneous command only generates the default display of the current context. 


Figure 3-2 shows a Menu of Commands display generated within the Global Context. The left side of the 


screen shows which commands are available within the current context (in this case, Global). The right 
side of the screen lists all Control Operation (#command) and Display Control commands. 
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Display Control and Control Operation Commands 


BAL DISPLAY CONTEXT #24 


###CONTROL OPERATIONS*** 
ALTER LINE DRAWING CHAR SET POSITION 
ENTER CPU-MEMORY MANAGER CONTEXT 
ENTER GLOBAL CONTEXT 
CONTINUOUS HARD COPY GENERATION 
ENTER I/O CONTEXT 
CLOSE LISTING FILE 
ENTER MEMORY CONTEXT 
ENTER PROCESS CONTEXT 
SUSPEND OPT (UNTIL USER INPUT) 
ENTER SYSTEM TABLES CONTEXT 
MENU OF CONTROL OPERATION COMMANDS 


#** DISPLAY CONTROL*##* 
EXIT 
HELP 
LISTING (GENERATE HARD COPY ) 


TIME CHANGE (OF UPDATE INTERVAL ) 


DEFINE XEQ SEQUENCE 


MPE COMMAND 
MENU DISPLAY 


NOTE COMMAND COMMAND? 


Figure 3-2. Menu of Commands - Global Display Context 


Note Command (!) 


This command allows you to place a note in the hard copy file, OPTLIST. After entering ' 


prompted with: 


> 


"t" you will be 


ENTER NOTE TO BE PRINTED ON FILE OPTLIST (enter ! to terminate) 


Each line you enter is copied directly to the file OPTLIST. If the file is not already open, the ae 


procedure for opening the hard copy file is followed. 


repeated until you enter a line consisting of a single exclamation point 





display 1s regenerated. 


(See the Listing command (L)). 


" " 
: 


The prompt 
. Then the message: 


is displayed. OPT/3000 pauses for approximately three seconds, the screen is cleared, and the current 
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Control Operation Commands (#) 


The Control Operation commands allow control of the various functions of OPT/3000. They are invoked 
by entering a pound (#) sign. Like Display Control commands, Control Operation commands maintain a 
unique meaning regardless of the current display context. 


The Control Operation commands will be discussed in two groups. The first group contains operations 
that provide information or provide some type of program control. The second group of commands 
provide access to specific contexts. 


The following is a list of Control Operation commands. 


#2? Menu Display for Control Operation commands 
#A Alter Line Drawing Character Set Position 

#H Continuous Hard Copy Generation Toggle 

#L Close Listing File 

#S Suspend OPT/3000 


#C Enter CPU-Memory Manager Context 
#G Enter Global Context 

#I Enter I/O Context 

#M Enter Memory Context 

#P Enter Process Context 

#T Enter System Tables Context 


These commands are available from any context whenever OPT/3000 is accepting commands. Upon 
entering a pound (#) sign, you are prompted with: 


ENTER CHARACTER FOR CONTROL OPERATION COMMAND 


Any character can be entered at this time. A character that is associated with a particular operation 
causes that operation to be executed. Any character that is not defined as a Control Operation command 
causes an error message. This error message echoes the illegal input, (in this case "Y" is used as an example) 
and then lists all valid commands. This error message is followed by another prompt: 


“Y’ IS NOT A VALID CONTROL OPERATION COMMAND 
VALID COMMANDS ARE A,C,G,H,I,L,M,P,S,T,? 


Only Control Operation commands are accepted as valid input. A or any other character is 
illegal. The error message, the list of Control Operations, and the prompt will be repeated until a valid 
character is entered. 


Display Control and Control Operation Commands 


Figure 3-3 illustrates the first group of Control Operation Commands. 
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Figure 3-3. Control Operation Commands (non-context) 
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Display Control and Control Operation Commands 


Menu of Control Operation Commands (#7) 


This command generates a menu of Control Operation commands as illustrated in Figure 3-4. All 
Control Operation commands are described in this menu. 


“¥*MENU OF CONTROL OPERATION. COMMANDS### 





#A - ALTER LINE DRAWING CHARACTER SET POSITION (if not in position B) 
#C - ENTER CPU-MEMORY MANAGER CONTEXT (user prompted for initial display) 
#G - ENTER GLOBAL CONTEXT (global resource usage report will be generated) 


#H - CONTINUOUS HARD COPY GENERATION TOGGLE (turn automatic hard copy on/off) 


#1 - ENTER 1/0 CONTEXT (user prompted for initial display) 
#L - CLOSE LISTING FILE (file OPTLIST sent to line printer) 
#M - ENTER MEMORY CONTEXT (user prompted for initial display) 
#P - ENTER PROCESS CONTEXT (program file display will be generated) 
#S - SUSPEND OPT (until next user command is entered) 
#T - ENTER SYSTEM TABLES CONTEXT (user prompted for initial display) 


#? - MENU DISPLAY OF CONTROL OPERATION COMMANDS (this display) 


COMMAND? 


Figure 3-4. Menu of Control Operation Commands 


Notice the difference in function between the two types of menu commands. The Control Operation 
Commands Menu (#?) allows access to the different contexts and program control commands. These 
commands allow you to shift from one context to another. 


The Context Command Menu (?) allows access to the displays in a particular context, Display Control 
commands, and Control Operation commands. These commands generate the different screen displays 
within a context. 


Display Control and Control Operation Commands 


Alter Line Drawing Character Set Position Command (#A) 


This command is used to inform OPT/3000 of the position of the line drawing character set if the 
character set on your terminal is not in position B. Generally, if your terminal has a line drawing 
character set, it will be in position B. While OPT/3000 assumes that the set is in position B, it can be 
operated when the character set is in positions A, C, or D. You must, however, notify OPT/3000 of the 
location with the (#A) command. 


The line drawing character set on your terminal is probably not in position B if the vertical and 
horizontal lines in the displays appear as commas or "funny" characters or if no lines appear at all. If this 
occurs and you wish to determine what position the character set is in, run a terminal test by pressing the 
TEST key or by using the terminal test softkeys. Consult your terminal reference manual to determine 
the location of the line drawing character set. Once you have found the location, you can use Alter Line 
Drawing Character Set Position Command (#A) to inform OPT/3000 of the correct position. 


ENTER POSITION OF LINE DRAWING CHARACTER SET (A, B, C, or D) 
If you do not reply with one of the values specified above, the following message appears: 
POSITION MUST BE EITHER A, B, C, OR D 


The error message and a new prompt will be repeated until valid input is received. When the location has 
been changed, OPT/3000 prints the following message, where "Z" represents the new location. 





OPT/3000 pauses for approximately three seconds, erases the above dialogue, and updates the current 
display. 


Continuous Hard Copy Generation Toggle Command (#H) 


This command allows you to control the continuous generation of hard copies of context displays. The 
continuous copy toggle is set OFF when OPT/3000 is entered. Typing the Continuous Hard Copy 
Command (#H) sets the toggle ON. When the toggle is ON, each display that is generated or updated is 
copied to the line printer. The copying of context displays to the printer continues until another 
Continuous Hard Copy Command (#H) is entered. This command will set the toggle OFF. When the 
toggle is ON, the context displays are copied to the OPTLIST file. 


When the continuous generation of hard copies is enabled, OPT/3000 prints the following message: 





Setting the hard copy toggle to the OFF position does not close the OPTLIST file. This file is closed upon 
termination of OPT/3000. OPTLIST can also be closed by the Close Listing File command (#L). 


Display Control and Control Operation Commands 


Close Listing File Command (#L) 


This command closes the file OPTLIST on which the hard copy displays are written. If the operation is 
successful, the following message is displayed on your terminal: 


) LINE PRINTER 





If no hard copy displays have been produced since the last file closing or since the start of execution, the 
following error message is displayed: . 





After one of the above three messages is displayed, OPT/3000 pauses for approximately three seconds, 
erases the message, and returns your screen to its original state, at which point normal operation 
continues. This command has no effect on the setting of the flag that controls the continuous generation 
of hard copy displays. This command only closes the OPTLIST file. (To stop hard copy generation, 
re-enter the #H command.) 


Suspend Command (#S) 


This command causes OPT/3000 to enter a suspended state, allowing you to examine your current display 
without it being updated. Normal operation is resumed as soon as you enter a character. The character 
which you enter to resume operation is treated as normal command input and thus may lead to a new 
display being generated. Suspension is limited to a maximum of 15 minutes (900 seconds), at which time 
your current display is updated. 


Display Control and Control Operation Commands 


Figure 3-5 illustrates the remaining Control Operation commands. These commands produce the effect 
of transferring you to a different context. 
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Figure 3-5. Control Operation Commands (context entry) 


Enter CPU-Memory Manager Context Command (#C) 


This command is used to change the current context to the CPU-Memory Manager Context. Upon 
entering the command, you are prompted for the desired display in the context. For further information, 
refer to the CPU-Memory Manager Context in Section 6. 


Enter Global Context Command (#G) 


This command is used to change the current context to the Global Context. Upon entering the command, 
the default display in the Global Context (Global Resource Usage Report) is generated. For further 
information, refer to Global Context in Section 5. 


Enter I/O Context Command (#1) 


This command is used to change the current context to the 1/O Context. Upon entering the command you 
will be prompted for the desired display in the context. For further information, refer to I/O Context in 
Section 8. 
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Enter Memory Context Command (#M) 


This command is used to change the current context to the Memory Context. Upon entering the 
command, you are prompted for the desired display in the context. For further information refer to 
Memory Context in Section 7. 


Enter Process Context Command (#P) 


This command is used to change the current context to the Process Context. Upon entering the command, 
you are prompted for the desired display in the context. For further information, refer to Process Context 
in Section 9. . 


Enter Systems Tables Context Command (#T) 


This command is used to change the current context to the System Tables Context. Upon entering the 
command, you are prompted for the desired display in the context. For further information refer to 
System Tables Context in Section 10. 


SECTION 


CONTEXT COMMANDS 





OPT/3000 consists of six contexts, each of which provides a detailed look at a specific system resource or 
entity. These six contexts are: 


Global Context 

CPU-Memory Manager Context 
Memory Context 

I/O Context 

Process Context 

System Tables Context 


The Global Context is the default context and is automatically selected when you run OPT/3000. 


Within each context there is a default display. Immediately upon entering the Global Context the default 
display is automatically generated. When entering all other contexts, you will be prompted for display 
selection, and the default appears only after an unprogrammed command or (RETURN). 


Figure 4-1 provides a summary of the six contexts and the displays within each context. 
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Figure 4-1. OPT Contexts and Displays 





SECTION 


GLOBAL CONTEXT (#G) 


The Global Context provides an overview of system memory, CPU, and disc activity; and a summary of 
jobs and sessions currently running. For problem solving, the Global Context indicates which resources 
warrant further investigation in another context. The Global Context can be accessed from any context 
by entering #G" between display updates, or whenever OPT/3000 accepts commands. 
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Figure 5-1. Global Context 


Two displays and one menu of commands are available in this context. 
(27). Menu of Commands - Global Display Context 
(G) Global Resource Usage Report Display (default) 
(P) Process Summary Display 


The Global Resource Usage Report (G) is the default display and is automatically generated when you 
enter this context. You also automatically enter this display when OPT/3000 is initially invoked. 
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Global Context (4G) 


By entering "?" once you are in a context, you produce a menu of commands for that context, as 
illustrated in Figure 5-2. 


wee MENU OF COMMANDS --- GLOBAL DISPLAY CONTEXT *#### 













wee DISPLAYS##% #e*xCONTROL OPERATIONS*##* 

G GLOBAL RESOURCE USAGE REPORT (default) |#A ALTER LINE DRAWING CHAR SET POSITION 
#C ENTER CPU-MEMORY MANAGER CONTEXT 

#G ENTER GLOBAL CONTEXT 

#H CONTINUOUS HARD COPY GENERATION 

J#I ENTER 1/0 CONTEXT 

#L CLOSE LISTING FILE 

#M ENTER MEMORY CONTEXT 

#P ENTER PROCESS CONTEXT 

#S SUSPEND OPT (UNTIL USER INPUT) 

#T ENTER SYSTEM TABLES CONTEXT 

#2 MENU OF CONTROL OPERATION COMMANDS 






§ STOP SUMMARY REPORT GENERATION 
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Figure 5-2. Menu of Commands - Global Display Context 


Upon entry to the global context 
the global resource usage report is 
automatically generated 


wong se MAP eos ah 


Responding to the menu prompt: 
COMMAND? 
with an unprogrammed command (or (RETURN)) generates the above context’s default display. 


The periodic generation of hard copy summary reports and the optional writing of the summary 
information to a disc log file is also controlled through the Global Context. 
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Global Context (4G) 


GLOBAL RESOURCE USAGE REPORT DISPLAY (G) 


The Global Resource Usage Report Display is generated automatically upon entry to the Global Context. 
To access this display from elsewhere in the Global Context, enter "G" when OPT/3000 is accepting 
commands. This display provides information about system memory usage, CPU activity, and disc I/O 
activity. | me fe ste | 

REPORT 9:26 AM 
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Figure 5-3. OPT/3000 Global Resource Usage Report 


Display Description 


This display is divided into three sections. The first shows the memory usage, CPU state, and disc I/O 
activity for the current interval. The current interval is the time between display updates that matches 
as closely as possible to the interval length. The current interval length may be slightly longer than the 
time set with the Time Change command due to overhead in OPT and the MPE instrumentation. The 
current interval is measured in seconds. 


The second portion of the screen shows the CPU state and disc I/O activity since the summary report 
totals were last reset. The overall interval is displayed in minutes. 


The bottom section of the display is the legend that defines each section of each bar graph. 
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Global Context (4G) 


Interpretation Guidelines 


e The peroentage of memory allocated to resident MPE depends on the actual memory size and 


configuration percentages. 


e A true CPU utilization factor is obtained by adding together the CPU busy, cache management, and 


overhead percentages. 


e No idle time should be observed as long as at least one batch job is active. 


Legend 


Memory usage is reported as the percentage of memory occupied by each of the following categories: 


Memory Resident MPE (M) 


Code Segments (C) 
Stack Segments (S) 
Data Segments (D) 


Cached Disc Domains (X) 


Memory permanently allocated to MPE for system tables and 
code. 


Linked memory currently occupied by code segments. 
Linked memory currently occupied by stack segments. 
Linked memory currently occupied by non-stack data segments. 


Linked memory currently occupied by disc cache domains. 


Any memory not allocated to one of the above uses is free space. 


CPU usage is reported as the percentage of time during the interval that the CPU is in each of the 


following states: 
Busy (B) 


Paused (P) 


Idle (I) 
Garbage Collection (G) 
Cache Management (X) 


Overhead (O) 


CPU time used for system and user processes. 


CPU waiting for completion of user and/or memory management 
disc 1/O. 


No process requires service. 
CPU time spent performing memory garbage collection. 
CPU time devoted to managing disc caching. 


CPU time spent executing on the ICS (Interrupt Control Stack) 
and CPU time used for memory allocation. 


All percentages for Memory and CPU usage are rounded to the nearest 2 percent. Percentages for CPU 
usage are adjusted after rounding to ensure that they total 100 percent. 
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Global Context (4G) 


Disc activity is reported as the mean number of disc I/O’s completed per second for each of the following 
three categories, rounded to the nearest integer: . - 


Cached I/O (X) Disc I/O completed for cache I/O. 
Segment Management (S) Disc I/O completed for memory management. 
User I/O (U) Disc I/O completed on behalf of a user or system process (includes 


spooling I/O). 
Both user and Memory Manager rates are rounded to the nearest integer, so a rate of less than 0.5 per 


second is not displayed. The maximum combined rate that can be displayed is 100 per second. The rates 
are shown in the form (user I/O rate/segment manager I/O rate/cache I/O rate). 
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Global Context (4G) 
PROCESS SUMMARY DISPLAY (P) 


To get to the Process Summary Display from elsewhere in the Global Context, enter "P' when OPT/3000 
is accepting commands. 


PROCESS SUMMARY DISPLAY | 1358 PM 
NUMBER OF CURRENT PROCESSES: 84 


10 20 30 40 50 60 70 80 90 100 





ACTIVE SESSIONS ( 37/ 37) 
ACTIVE JOBS ( 4/ 4) 
SYSTEM PROCESSES ( 25/ 25) 
CI PROCESSES ( 25/ 25) 

USER PROCESSES ( 16/ 16) 
CREATED PROCESSES ! ( 2/ 2) 
IN DISPATCH QUEUE ( 1/ 1) 
IN NO QUEUE ( 83/ 83) 








LEGEND: CI PROCESSES INCLUDE ONLY |ENTER: 


THOSE JOBS AND SESSIONS G FOR GLOBAL RESOURCE USAGE REPORT 


} CURRENT NUMBER |THAT ARE CURRENTLY IN THE | 
COMMAND INTERPRETER H FOR HELP 


CREATED PROCESSES ARE SONS # FOR CONTROL OPERATION COMMAND 
OF USER PROCESSES 


Figure 5-4. Process Summary Display 


The Process Summary Display provides high-level summary information about the processes, sessions and 
jobs currently present on your system. The display describes the state of the system at the time it is 
generated and does not provide averages over time. The display does, however, provide both current and 
maximum observed values for each item displayed. 


Display Description 
The display bar graphs are grouped into three areas: 
Sessions and Jobs 
Processes 
Dispatch queue/no queue 
The current value is shown by the dark portion of the bar, and the observed maximum is shown by the 
white portion of the bar. If there is no white portion, then the current value is also the maximum. An! 


is used to indicated the last position of the dark portion for those users with displays that do not have the 
half bright capability. 
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Global Context (4G) 


The maximum observed values refer only to values recorded in the current Process Summary Display. For 
example, if there were 20 sessions while the current display was the Global Resource Usage Report and 
there were 19 sessions while the current display was the Process Summary Report, the maximum would be 
shown as 19. 


Interpretation Guidelines 


e <A large number of processes in the dispatch queue (greater than 5) may indicate excessive contention 
for either the CPU or for discs. 


e The number of system processes should remain relatively constant. 


e Additional information about the number of processes in the various process states can be obtained 
using the Process State Report Display in the Process Context. 


e The number of current processes reported on the top of the screen should equal the total of the system 
processes, CI processes, user processes multiplied by two, and created processes. 


NOTE 


Since the number of CI processes does not include those processes where 
users are running a program the number of user processes must be counted 
twice. 


Legend 
Processes are detailed in the second grouping of the display. They include System, Command Interpreter, 
User, and Created processes. 

System Includes such processes as spoolers and memory logging. 


Command Interpreter Includes only those CI processes that are not waiting on a son 
process (i.e., the user is running a program or is in break). 


User The son processes of CI processes (user main processes). 

Created The son of a user process or the son of another created process. 
Processes in the Dispatch Queue are essentially ready to run and are waiting for the CPU, an absent 
segment to be brought into memory, or a disc I/O to complete. A process in the Dispatch Queue may have 


some of its memory taken away in order to satisfy a memory management request, but it will remain in 
the Dispatch Queue. If so, the process will be marked as requiring scheduling attention. 
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Global Context (4G) 


A process in the "no queue" state is waiting for some long term event such as a terminal READ completion 
or the acquisition of a RIN. Once the event occurs, the process in the "no queue" state will be placed in 
the Dispatch Queue. | . 

Dispatch Queue The process is ready to run and is on a short term wait. 


No Queue . The process is waiting for a long term event after which it will be 
| placed back in the Dispatch Queue. 
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SUMMARY REPORT HP32238A.00.28 OPT/3000 : TUE, OCT 7, 1986, 10:45 AM PAGE 1 
(C) HEWLETT-PACKARD COMPANY 1979, 1980 OPT summary report 
INTERVAL LENGTH: 413.154 SECONDS ( 6.9 MINUTES) 
CPU ACTIVITY SUMMARY : MEMORY ALLOCATION SUMMARY 
CPU STATE MEAN MAX LENGTH. COUNT TOTAL TIME RESULT MEAN. COUNT 
.CPU BUSY 20% 41% .009 9304 80.727 RECOVERY 0% 1 
PAUSE DISC & SWAP 0% 0% .027 2 .053 FREE SPACE 98% 915 
PAUSE DISC 4% 17% .026 591 15.347 OVERLAY CAND 0% 1 
PAUSE SWAP 1% 5% 032 169 5.377 GIVE UP 2% 15 
PAUSE IDLE 67% 85% 132 2142 281.687 HARD REQUEST 0% 0 
GARBAGE COLLECTION 0% 0% 0 .000 
SEGMENT MAM-ICS 1% 2% .003 932 2.505 
CACHE MAM-PROC STK 4% 12% .003 4971 16.131 
CACHE MAM-ICS 0% 767 
OVERHEAD 3% 10.560 
LAUNCH ACTIVITY AND ADDITIONAL MEMORY MANAGEMENT ACTIVITY SUMMARY ; 
PROCESS PROCESS PROCESS ~ MEMORY SPECIAL MM 1/0 MM 1/0 RELEASE RELEASE CLOCK 
LAUNCHES SWAP-INS PREEMPTS ALLOCS REQUESTS READS WRITES DATA SEG CODE SEG CYCLES 
COUNT 9304 931 1663 972 185 362 150 2 0 0 
RATE 22.5 2. 4.0 2.4 : ; 4 0 .0 .O 
MAX RATE 37 8 9 8 1 2 1 0 0 ie) 
SUMMARY OF DISC ACTIVITY 
COUNT /RATE MAXIMUM RATE(USER/MM AND CACHE ) 
ALL 1/0 READS WRITES CONTROL OPS READS WRITES CONTROL OP 
ALL DISC 1971/ 4.8 721/ 1.7 967/ 2.3 283/ 7 0/ 5 2/il 3 
DISC 1 (LDEV 1) 776/ 1.9 316/ 8 388/ .9 72/ 2 0/ 3 1/ § 1 
DISC 2 (LDEV 2) 547/ 1.3 144/ 3 271/ .7 132/ 3 0/ 2 As 4 2 
DISC 3 (LDEV 3) 227/ 5 108/ 3 88/ .2 31/ 1 O/ 2 0/ 3 1 
DISC 4 (LDEV 4) 421/ 1.0 153/ 4 220/ ae) 48/ 1 0/.2 1/ 6 1 
SUMMARY OF LP ACTIVITY 
, - COUNT/RATE MAXIMUM RATE 
ALL I/O WRITES CONTROL OPS WRITES CONTROL OP 
ALL LP 0/ 0 0/ 6 0/ 0 0 0 
SUMMARY OF TAPE ACTIVITY 
: COUNT /RATE MAXIMUM RATE 
ALL 1/0 READS WRITES CONTROL OPS READS WRITES CONTROL OP 
ALL TAPE 0/ .0 0/ .0 0/ .0 0/ .0 0 0 =O 


LYOd4aYd AYVANWNS 


‘QpOUl Y9}eq UI JO ATAATJORIAqUT 


paonpoid aq uvo yrodas sty, “Adoo prey uo wlaqsAs INCA Jo MATA [[eIIAO UB SapIAoid yloday AreuUINS a4] 


(OF) 1X97U0D [BQOID 


Global Context (4G) 


In an interactive environment, the Summary Report is controlled from the Global Context. The 
commands to control the report are: 


A - Activate Summary Report generation 
S - Stop Summary Report generation 
R - Generate Single Summary Report 
Z - Zero Totals command 
These commands are discussed in detail in the additional commands section. 


In batch mode, the Summary Report is controlled by supplying the answers to five questions ina stream 
file. (See Appendix D for an example of a Batch Job File). They control the number of reports, the 
availability of the reports and the interval over which the reports are to be generated. A listing is defined 
as one closing and reopening of the report file, and may include several summary reports. The questions 
are: 


MINUTES BETWEEN SUMMARY REPORTS? 

REPORTS BETWEEN CLOSING OF REPORT FILE? 

FILE CLOSINGS BEFORE TERMINATION? 

NAME OF LOG FILE? 

SUMMARY REPORT IDENTIFICATION? (max of 50 chars) 


The first question allows you to specify the approximate interval (in minutes) between summary reports. 
The interval may actually be slightly larger because of the time necessary to generate the reports. The 
default interval is 60 minutes. The largest interval that may be specified is 32,767 minutes. 


The second question determines the number of summary reports that are generated before the spool file is 
closed and reopened. The page numbering is continuous throughout all of the summary reports. The 
default is 8 reports. The maximum number of reports allowed before closing the spool file is 32,767. 


The third question determines the number of listings produced. The default is three listings and the 
maximum is 32,767 listings. One listing is produced each time the spool file is closed. 


The fourth question determines whether a log file is generated. The default does not produce a log file. 
When you answer with a name, a log file will be produced under that name. If a file already exists with 
that name, one of two things happens. In batch mode, the old file is purged and a new file built. In 
interactive mode, you will be asked if the old file is to be purged so that a new file can be produced. See 
Appendix B for additional information about the log file. . 


The fifth question asks for a title which will be used to label the summary reports. The default input is 
no title. You can enter up to 50 characters for a title. 


If an end-of-file is encountered in the stream file before you answer all five questions, the default 
answers are assigned to the remaining questions. You may also choose to answer only particular questions 
and let the others assume the default values, by answering with a or blank record in the stream 
file. Any question answered without any data supplied assumes the default value. 


One final summary report summarizes the information over all intervals. Each of the previous reports 
cover only one interval. 
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When generating summary reports in batch mode using all the default values, you will receive three line 
printer listings. Each listing contains eight summary reports. The OPT/3000 program runs for 
approximately 24 hours. The fourth listing contains the final summary report. Note that pagination is 
continuous throughout all of the reports. 


Display Description of the Summary Report 
The report is divided into six parts: 


CPU Activity Summary 
Memory Allocation Summary 
Launch Activity and Additional Memory Management Activity Summary 
Summary of Disc Activity 
- Summary of LP Activity 
Summary of Tape Activity 


The CPU Activity Summary displays the use of the CPU in terms of time. The activities are broken down 
into individual states that are measured. Each state is described by five quantities: mean, max, length, 
count and total time. The mean is the overall average of the individual summary report intervals. The 
max is the largest percentage measured in the current interval. The final summary report will show the 
maximums encountered during the entire summary report generation period. The length is the mean time 
in seconds that the CPU remained in that particular state. The count is the number of times that the 
CPU entered in a particular state. The total time is the total amount of time the CPU spent in any 
particular state within the current interval. 


The Memory Allocation Summary gives a breakdown of the action taken by the Memory Manager. The 
result column is the identification of each type of action that the Memory Manager can take when a . 
memory request is made. The mean is the percentage of times that the Memory Manager performed a 
particular type of action. The count is the actual number of times that the Memory Manager performed 
a particular type of action. 


The Launch Activity and Additional Memory Management Activity Summary shows the different types 
of activity initiated by the dispatcher. These activities show the various actions of the operating system 
broken down into the different types of activities. The count is the actual number of times that a 
particular type of activity took place. The rate is the average rate of activities per second. The max rate 
is the highest rate obtained in the current interval. The final summary report shows the maximums 
encountered during the entire summary report generation period. 


The summaries of device activity appear at the bottom of the summary report. There are three 
summaries: Summary of Disc Activity, Summary of LP Activity, and Summary of Tape Activity. Each 
has entries for each device of a particular type and an entry for the total activity of all the devices of 
that type. The activity is broken down into reads, writes, control operations, and all I/O (the sum of reads, 
writes, and control operations). The activity of each device is measured by a count, a rate per second, and 
a maximum rate. 
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Interpretation Guidelines 


e Process swap-ins can cause memory allocs and/or special requests. 


e Process swap-ins <= memory allocs + special requests. 


e The line printer and tape are not accessed by the Memory Manager. 


e Total user wait time <= pause disc + pause disc & swap. 


e Total system wait time <= pause disc + pause disc & swap. 


Legend 


The CPU Activity Summary provides detailed information about CPU utilization over the time interval. 
This activity is divided into occurrences of various CPU states. These states are: 


Busy 


Pause Disc & Swap 


Pause Disc 

Pause Swap 

Pause Idle 

Garbage Collection 
Segment MAM-ICS 
Cache MAM-PROC STK 


Cache MAM-ICS 


Overhead 


CPU time for system and user processes. 


CPU waiting for completion of both user and memory 
management disc I/O. 


CPU waiting for completion of user disc I/O. 

CPU waiting for completion of memory management disc I/O. 
No process requiring service. 

CPU time on garbage collection. 

CPU time on memory allocation. 

CPU time on disc caching while executing on user stack. 


CPU time on disc caching while executing on the Interrupt 
Control Stack. 


System activity not included in above categories such as interrupt 
handling and process scheduling. 


The Memory Allocation Summary section further breaks down memory allocation into: 


Recovery 


Free Space 
Overlay Candidates 


Give Up 


Segment recovered from overlay candidate state, either at the 
time of a fault or during a process swap-in (i.e., no disc activity). 


Free space (available region) was found for the segment. 
One or more new overlay candidates were made. 


The attempt to allocate memory was postponed for one of the 
following reasons: 


Hard Request 


Global Context (4G) 


e More urgent pending activity. 


e The clock cycle rate for the clock algorithm exceeded the 
threshold value. ; 


A hard request was used to satisfy the request. If a memory 
allocation fails, for the highest priority process in the dispatch 
queue due to excessive memory contention, a hard request is issued 
to force the segment into memory. 


The Launch Activity and Additional Memory Management Activity Summary shows the activity 
associated with the dispatch of processes. These different types of activity are: 


Process Launches 


Process Swap-Ins 


Process Pre-empts 


Memory Allocations 


Special Requests 

MM I/O Reads 

MM I/O Writes 
Release Data Seginents 


Release Code Segments 


Clock Cycles 


Number of times the dispatcher launched a process. This includes 
system processes. . 


Number of times the dispatcher swapped-in a process. This 
indicates that the process required one or more memory 
allocations before it could be launched. 


Number of times a process was preempted in order to launch a 
more urgent process. 


Number of memory allocations. attempted by the Memory 
Manager. The allocation of space may require more than one 
attempt. 


Number of times there was a request for a segment lock or some 
form of segment expansion. 


Number of times the Memory Manager read a segment into 
memory. 


Number of times the Memory Manager wrote data segments to 
virtual memory. 

Number of data segments released by the Memory Manager. 
Number of code segments released by the Memory Manager. 


Number cf times the Memory Manager returns to the start of 
linked me:nory while attempting to make overlay candidates. 


The Summary of Disc Activity provides infermation about each individual disc. This summary also 
includes an overall summary of all the discs on the system. 


All I/O 
Reads 
Writes 


Control Ops 


Number and rate of all reads, writes, and control operations. 
Number and rate of reads. 
Number and rate of writes. 


Number and rate of control operations. 
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(Maximum Rates) 


Reads 
Writes 


Control Ops 


Maximum rate of reads in an interval (USER/MM). 
Maximum rate of writes in an interval (USER/MM). 


Maximum rate of control operations in an interval (USER/MM). 


The Summary of LP Activity provides information about each individual LP. This summary also includes 
an overall summary of all the LPs on the system. 


All 1/O 

Writes 

Control Ops 
(Maximum Rates) 
Writes 


Control Ops 


Number and rate of all writes and control operations. 
Number and rate of writes 


Number and rate of control operations. 


Maximum rate of writes in an interval. 


Maximiim rate of control operations in an interval. 


The Summary of Tape Activity will give information about each individual tape. This summary also 
includes an overall summary of all the tapes on the system. 


All 1/O 

Reads 

Writes 

Control Ops # 
(Maximum Rates) 
Reads 

Writes 


Control Ops 


Number and rate of all reads, writes, and control operations 
Number and rate of reads 
Number and rate of writes 


Number and rate of control operations 


Maximum rate of reads in an interval 
Maximum rate of writes in an interval 


Maximum rate of control operations in an interval 


Global Context (4G) 
ADDITIONAL COMMANDS 


The additional commands in the Global Context allow you to control the generation of hardcopy summary 
reports. These commands are available from both the Global Resource Usage Report Display and the 
Process Summary Display in addition to the menu for this context. The commands are: 


A - Activate Summary Report Generation 
S - Stop Summary Report Generation 
R - Generate Single Summary Report 


‘Z - Zero Totals Command 


Activate Summary Report Generation Command (A) 


This command activates periodic generation of summary reports and disc file logging. The summary 
reports are generated on the file OPTREPT with a default device class of LP”. 


The command "A" can only be accessed from within the Global Context. When the command is entered, 
you will be prompted with a four question dialog: 


MINUTES BETWEEN SUMMARY REPORTS? 

REPORTS. BETWEEN CLOSING OF REPORT FILE? 

NAME OF LOG FILE? 

ENTER SUMMARY REPORT IDENTIFICATION (max of 50 chars) 


The first question allows you to specify the approximate interval at which summary reports are generated. 
The interval may actually be slightly longer than you have requested because the summary report interval 
is checked by OPT/3000 after each display interval. For example, suppose the Summary Report interval 
is set for one minute and the display interval is set at 25 seconds. The first Summary Report will be 
generated at one minute and 15 seconds. (The display interval elapses at 25 seconds, 50 seconds, one 
minute 15 seconds, and so on. The first interval to elapse after the one minute Summary Report time is 
the interval at one minute 15 seconds). 


Your response must be a positive integer. If it is not, the message: 
### RESPONSE MUST BE POSITIVE INTEGER ### 
is displayed and the prompt repeated. 
The second question allows you to specify the number of summary reports you want to generate before 
closing the file OPTREPT. This feature is primarily provided to allow the printing of the summary reports 


before OPT/3000 terminates. It also reduces the possibility of summary reports being lost in the event of 
a system failure. Note that page numbers on the reports are not reset when OPTREPT is closed. 
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If you do not respond with a positive number, you receive the warning: 

### RESPONSE MUST BE POSITIVE INTEGER ### 
The third question allows you to identify a log file. If you respond with a (RETURN), no log file is created. 
When you specify a valid file name, OPT/3000 checks to see if the file already exists, and if so, prompts 
you with: 

PURGE OLD COPY OF LOG FILE? (YES/NO) 
If you reply "NO", the log file name prompt is repeated. 


If, for some reason, OPT/ 3000 cannot purge the old copy of your log file, ‘you receive the following 
message: 





followed by a file system error message and the repeat of log file prompt. 


If, for any reason, OPT is unable to open the log file you have specified, you will receive the message: 





followed by a file system error message. The log file name prompt is repeated. For a description of the 
log file format, see Appendix B. 


The final prompt received after entering the Activate command "A" is: | 


ENTER SUMMARY REPORT IDENTIFICATION (max of 50 chars) 
> , 


You should now enter a string of up to 50 characters that you want to appear in the heading of each 
summary report generated. This heading is different from the identification that is specified for the 
heading of each hard copy display. 


Once the above dialog is successfully completed, you are notified by: 


SUMMARY REPORT. GENERAT. 





OPT/3000 pauses for approximately three seconds, erases the terminal screen and updates the current 
display. If the Summary Report is already activated when you enter the Activate Command (A), 
OPT/3000 displays the message: 


SUMMARY REPORT GENERATION AL{ 


DO YOU WISH TO TERMINATE REPO 











2? (YES/NO) 


A "NO" response allows Summary Report generation to continue and the previous display to be updated. 
"VES" terminates the existing report generation and initiates the Activate Command dialog described 
above. 
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Stop Summary Report Generation (S) 


This command terminates generation of summary reports. It can only be accessed from the Global 
Context. When entered, it closes the OPTREPT file if any summary reports have been generated since the 
last closing of OPTREPT. An overall summary report is produced for the entire time during which 
summary reports were generated. Note, however, that activity between the last summary report and the 
termination of summary report generation is not included in the overall summary report. 


If the Summary Reporting is not active, entering the Stop (S) command generates the message: 





NERATION NOT ACTIVE 


If you requested a log file in the Activate (A) command and OPT/3000 is unable to close it, the message * 





is displayed, followed by a file system error message and the prompt: 
PRESS RETURN TO CONTINUE 
OPT/3000 pauses until you enter a (RETURN). 


After Summary Report generation is terminated, OPT informs you by displaying: 





All totals are reset to zero and OPT/3000 pauses for approximately three seconds before erasing your 
screen and updating the current display. 


Generate Single Summary Report (R) 


This command generates a single copy of a summary report on the file OPTLIST. The command is 
accessed from the Global Context by entering "R", and is available only when summary report generation 
is not active. Trying to use this command while summary report generation is active will produce the 
message: 





If you enter the command (R) under the correct conditions (while summary report generation (A) is not 
active), OPT/3000 will generate the following message: 


ENTER HARD COPY IDENTIFICATION (max of 50 chars) 
> 


You should enter a string of up to 50 characters that you want to appear in the heading of each summary 
report generated. 
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Once the above dialog is successfully completed, you are notified by: 





SINGLE SUMMARY REPOR 





GENERATED ‘ON OP 





OPT/3000 then pauses for approximately three seconds, erases the above message and updates the current 
display. Similar to periodic summary report generation, totals are not reset to zero after the single 
summary report is generated. 


Zero Totals Command (Z) 


This command sets the totals used to provide information about the summary reports to zero. It is 
accessed from the Global Context and is not allowed while summary report generation is active. 


If you enter the command while summary report generation is active, the message: 





is displayed. If the command is entered when summary reporting is not active, OPT/3000 confirms the 
reset with: 





OPT/3000 pauses for approximately three seconds, erases the above message, and updates the current 
display. 


CPU/MEMORY MANAGEMENT 


CONTEXT (#C) 





The CPU-Memory Manager Context details memory allocation by the Memory Manager and monitors 
CPU activity. 
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Figure 6-1. 
CPU Memory Manager Context 


GLOBAL 































HISTOGRAM 





This context is accessed by entering "#C" between display updates or whenever when OPT/3000 is 
accepting commands. 


Three displays and one menu of commands are available in this context. They are: 
(?) Menu of Commands - CPU-Memory Manager Context 
(R) CPU Memory Management Report Display **default** 
(C) CPU Usage Display 
(M) Memory Management Activity Display 
The CPU-Memory Management Report Display gives a general overview of both the CPU and the 


Memory Management activity and is the default display. The CPU Usage Display and the Memory 
Management Activity Display give more detailed analyses of these two system resources. 
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Upon entering the CPU-Memory Manager Context, OPT /3000 prompts: 


ENTER COMMAND FOR DISPLAY (? FOR MENU): 


If you enter an ia cetaracc command or (RETURN), the default display will be generated. By entering a 


"2", OPT/3000 details display options within this context and all Display Control Commands. This is 
illustrated i in Figure 6-2. 


aeeeee MENU OF COMMANDS 















wHHDISPLAYS#¥H | 


fA ALTER LINE DRAWING CHAR SET POSITION 

#C ENTER CPU-MEMORY MANAGER CONTEXT 

4G ENTER GLOBAL CONTEXT 

#H CONTINUOUS HARD COPY GENERATION 

R CPU-MEMORY MANAGEMENT REPORT (default) |#I ENTER I/O CONTEXT 

#L CLOSE LISTING FILE 

#M ENTER MEMORY CONTEXT 

#P ENTER PROCESS CONTEXT 

; SUSPEND OPT (UNTIL USER INPUT) 
ENTER SYSTEM TABLES CONTEXT 


? MENU OF CONTROL OPERATION COMMANDS 


C CPU USAGE 


M MEMORY MANAGEMENT ACTIVITY 


& EXIT 
H HELP 





L LISTING (GENERATE HARD COPY) 
T TIME CHANGE (OF UPDATE INTERVAL) 
® DEFINE XEQ SEQUENCE 


= MPE COMMAND 


~ MENU DISPLAY 


*£ NOTE COMMAND 





Figure 6-2. Menu of Commands - CPU Memory Manager Display Context 


Responding to the menu prompt: 


COMMAND? 


with an unprogrammed character (or a RETURN) generates this context’s default display. 
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CPU-MEMORY MANAGEMENT REPORT DISPLAY (R) 


The CPU-Memory Management Report Display is accessed by entering "R" while in the CPU-Memory 
Manager Context. 





CPU-MEMORY MANAGEMENT REPORT CURRENT INTERVAL: 3.9 SECONDS 10:22 AM 
| OVERALL INTERVAL: .1 MINUTES 
10 20 .30 40 50 60 70 80 90 100 per second 
PROCESS LAUNCHES ~©% (20/19) 
PROCESS SWAP-INS ~$ (4/4) 
MEMORY ALLOCATIONS $ : (4/4) 
60 70 80 90 













ne 
CURRENT CPU STATE B At 
OVERALL CPU STATE B 


CURRENT MM ACTION F (15) 






@ CPU DISPLAY 


M MM DISPLAY 


PECEND: PROCESS LAUNCHES & SWAP- aS & MEMORY ALLOCATIONS | ENTER: 


Figure 6-3. CPU-Memory Management Report 


This display is the default for the context and provides summary level information about CPU and 
memory management activity in three different areas: 


e Information about the rate per second occurrence of: 
Process launches 
Process swap-ins 
Memory allocations 


e Breakdown of CPU states 


e Breakdown of the results of all memory allocation attempts 
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Display Description 


The first section of the screen features a bar graph measuring the rate per second of process launches, 
process swap-ins, and memory allocations. The gray area (inverse video half-bright) shows the rate per 
second during the current sampling interval of the three events and is delimited with an ! at the end. 
The white area (inverse video, full bright) of the bar indicates the maximum rate per second over all 
intervals. The asterisk (*) denotes the average rate per second over all intervals since the last summary 
report was generated. The current interval is measured in seconds and the overall interval is measured in 
minutes. All rates are measured per second. If the current rate portion of the bar (!) and the mean are in 
the same location, a "$" is displayed there. All rates are rounded to the nearest integer, so a rate of less 
than 0.5 per second is not displayed. If no gray area appears, the rate for the current interval is less than 
0.5 per second. If no white area is present, the current rate is also the maximum rate. OPT/3000 also 
displays the rate in the form (current rate / maximum rate) to the right of the bar. 


The second section of the screen features a percentage bar that breaks CPU activity and memory 
management into subcategories. Subcatagories of CPU activity are shown as a percentage of overall CPU 
activity. Subcategories of memory management appear as a percentage of all memory allocations 
requested. All percentages are rounded to the nearest two percent and are then further adjusted so that 
they total 100 percent. The total number of memory management actions during the current and overall 
intervals is displayed in parentheses to the right of the respective bar graph. 

The bottom third of this display contains a legend for the CPU and Memory Manager activity bars and a 
separate legend for process activity and memory allocation rate bars. 


interpretation Guidelines 


e A true CPU utilization factor is obtained by adding the CPU busy, memory allocation, garbage 
collection, cache management, and ICS overhead percentages. 


e Background garbage collection takes place only when the CPU would otherwise pause (disc & swap, 
disc, swap, or or idle pauses). 


e No idle time should be observed as long as at least one batch job is active. 
e Total user wait time <= pause disc + pause disc & swap. 


e Total system wait time <= pause swap + pause disc & swap. 


Legend 


CPU/Memory Management Context (#C) 


The following three events are tallied on rate per second bars: 


Process Launch 


Process Swap-In 


Memory Allocation 


CPU State Descriptions 


Number of times the dispatcher launched a process, including 
system processes. . 


Number of times the dispatcher swapped-in a process. This 
indicates that the process required one or more memory 
allocations, before it could be launched. 


Number of memory allocations attempted by the Memory 
Manager. The allocation of space may require more than one 
attempt. 


The CPU state percentage bars detail the CPU time spent in each of the nine following states: 


B 


P 


(BUSY ) 


(PAUSED FOR DISC 
AND SWAP) 


(PAUSED FOR DISC) 


(PAUSED FOR SWAP) 


(IDLE) 


(GARBAGE COLLECTION) 


(MEMORY ALLOCATION) 
(ICS OVERHEAD) 


(CACHE MANAGEMENT 
FOR PROCESS) 


CPU time for system and user processes. 


CPU waiting for completion of both user and memory manage- 
ment disc I/O. 


CPU waiting for completion of user disc I/O only. 


CPU waiting for completion of memory management disc I/O 
only. 


No process requires service. 


CPU time on global garbage collection. 


CPU time on memory allocation. 
CPU time while executing on the Interrupt Control Stack. 


CPU time for cache management for system and user processes. © 
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Memory Management Action Descriptions 


The memory management action bars detail the percentage of methods used in response to memory 
requests. Five memory management actions are possible: 


R (RECOVERY) Segment was recovered from overlay candidate state, either at 
the time of a fault or during a process swap-in (i.e., no disc 
activity). 

F (FREE SPACE) | Free space (available region) was found for the segment. 

O (OVERLAY CANDIDATE) One or more new overlay candidates were made. 

G (GIVE UP) The attempt to allocate memory was postponed for one of the 


following reasons: 
e More urgent activity pending. 


e The clock cycle rate for the clock algorithm exceeded the 
threshold value. 


e Another process will be ready to run soon. 
H (HARD REQUEST) A hard request was used to satisfy the request. If a memory al- 
location fails for the highest priority process in the dispatch 


queue due to excessive memory contention, a hard request is is- 
sued to force the segment into memory. 
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CPU USAGE DISPLAY (C) 


The CPU Usage Display is accessed by entering "C" while in the CPU-Memory Manager Context. This 
display provides detailed information about CPU usage during both the current sampling interval and 
since the last summary report was generated. Information is provided about the occurrence of various 
CPU states during the interval and the rate of process launches and pre-emptions. 


CPU USAGE DISPLAY CURRENT INTERVAL: 14.1 SECONDS 9:36 AM 
OVERALL INTERVAL: 2.5 MINUTES 
10 20 30 40 50 60 70 80 90 100% 
CURRENT CPU STATE B — BDDI cee iy ey es Ey 








OVERALL CPU STATE B BDI 
10 20 30 40 50 60 70 80 90 100 per second 
PROCESS LAUNCHES s**t - oe (20/21) 
PROCESS PREEMPTS #¢ (5/4) 













CPU STATE INFO AVG TIME IN STATE(ms) STATE PERCENTAGES 


CURRENT OVERALL CURRENT OVERALL 


CACHE MAM-PROC STK 48 35 — 3.4% 1.8%| AVERAGE CPU 
CACHE MAM-ICS 0 0 3%  .1%| TIME PER 
SEGMENT MAM - ICS 3 3 7% .3%| TRANSACTION 
PAUSED DISC & SWAP 0% .0%| OF INTERACTIVE 
PAUSED FOR DISC 20 26 3.2% 1.5%] PROCESSES 


PAUSED FOR SWAP 15 23 4% 4% 
IDLE 224 166 739.2% 80.5% 

GARBAGE COLLECTION . 0% . 0% 
CPU BUSY 6 9 11.3% 14.0% 


CURRENT: 258 MS 
MAXIMUM: 288 MS 


B CPU busy P Pause disc & swap D Pause disc S Pause swap|? E 


$ BOTH MEAN & CURRENT 


I Idle G Garbage collect M Mem all-segQ Overhead 


Figure 6-4. CPU Usage Display 


Display Description 


The top section of the display reflects current and overall use of the CPU. The CPU state is broken down 
into categories by a percentage bar with each subcategory shown as a percentage of the overall category. 
All percentages are rounded to the nearest two percent and are then further adjusted so that they total 
100 percent. The inverse video half- and full~bright are used to distinguish between the nine CPU 
states. As indicated at the top of the screen, current interval length is shown in seconds and overall inter- 
val length is shown in minutes. 
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The second section of this display shows the rate per second of process launches and process preemptions. 
The gray area, or inverse video half-bright area of the bar used here, shows the rates per second during 
one sampling interval and is delimited by an exclamation mark (!) to denote the end. The white, or in- 
verse video full-bright area of the bar, indicates the maximum rate per second observed during any in- 
terval. The presence of an asterisk (*) indicates the average rate per second of launches or preemptions 
since the last summary report was generated. If the end of the current rate of the bar (!) and the mean 
fall in the same location, a "$" is displayed. . 


All rates are rounded to the nearest integer, so a rate of less than 0.5 per second is not displayed. If no 
gray area is present, the rate for the current interval is less than 0.5 per second. If no white area is 
present, the current rate is also the maximum rate. The current and maximum rates will appear to the 
right of the bar in the form (current rate / maximum rate). 

The third section of the screen shows the mean time the CPU spent in various states, measured in seconds, 
for both the current and overall intervals. The ICS overhead state is not shown in this particular portion 
of the display. The average time indicated is the number of milliseconds that the CPU spent in the 
specified state until the dispatcher was next entered. If no value is displayed for a particular state, then 
the state did not occur during the interval. 

Also shown in this section is the percentage of time in each state for the current and overall intervals. 
Note that the interval length at the top of the screen is measured in seconds and must be converted to mil- 
liseconds in order to calculate the percentages shown. 

The fourth part of the screen shows the average CPU time per transaction of interactive processes. It 
shows both a mean time and a maximum time in milliseconds. 


Interpretation Guidelines 


e A true CPU utilization factor is obtained by adding the CPU busy, CPU on memory allocation and 
caching, and ICS overhead percentages. 


e The average time in the CPU state is the CPU time between process quiesces. 


e Large “average short transitions" value means that the workload of the system consists of mainly 
CPU-bound transactions. 


e No idle time should occur if at least one batch job is active. 
e ICS overhead includes dispatcher activity and interrupt handling. 
e Total user wait time <= pause disc + pause disc & swap. 


e Total system wait time <= pause swap + pause disc & swap. 
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Legend 


CPU State 


Process Launches 


Process pre-empts 


The nine CPU states are: 
B (BUSY ) 


P (PAUSED FOR DISC 
AND SWAP) 


D (PAUSED FOR DISC) 


SS) (PAUSED FOR SWAP) 


I (IDLE) 


G (GARBAGE COLLECTION) 


M (MEMORY ALLOCATION) 


O (ICS OVERHEAD) 


x (CACHE MANAGEMENT ) 


CPU/Memory Management Context (#C) 


Subdivides elapsed time for the interval into nine 
CPU states on a percentage bar. 


CPU time for system and user processes. 


CPU waiting for completion of both user and 
memory management disc I/O. 


CPU waiting for completion of user disc I/O. | 


CPU waiting for completion of memory manage- 
ment disc I/O. 


No process requiring service. 


CPU time on garbage collection. 


CPU time on memory allocation. 


CPU time while executing on the Interrupt Control 
Stack. 


CPU time for cache management. 


Rate per second the dispatcher launched a process, 
including system processes. 


Rate per second of process pre-empts in order to 
launch a more urgent process. 


Gs? 


CPU/Memory Management Context (#C) 
MEMORY MANAGEMENT ACTIVITY DISPLAY (M) 


The Memory Management Activity Display is accessed by entering "M" while in the CPU-Memory 
Management Context. 
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Figure 6-5. Memory Management Activity 


This display provides detailed information on Memory Management Activity for the current sampling in- 
terval and since the last summary report was generated. Specifically, the screen displays the rate of 
memory allocation attempts by the Memory Manager, the results of the attempts, the amount of memory 
management-related disc I/O’s, and the number of segments released from memory by the Memory 
Manager. 


Display Description 


The first section of this screen displays current and overall memory management action on a percentage 
bar. This bar breaks down memory management actions into subcategories with each subcategory shown 
as a percentage of the total. All percentages are rounded to the nearest two percent and adjusted after 
rounding so they total 100 percent. The total number of memory management actions during the current 
and overall intervals is displayed in parentheses to the right of the respective bar graph. 


CPU/Memory Management Context (#C) 


The second section measures the rate per second of current and overall memory allocations, process 
swap-ins, segment reads and writes, and the release of cache domains, data and code segments. The rates 
are also displayed in numerical form on the right. The format is (current rate/overall rate). 


The gray area (inverse video half-bright) shows the rate during the current sampling interval and is 
delimited by an "!". The white area (inverse video full-bright) shows the maximum rate per second 
during any interval. The asterisk indicates the mean rate per second since the last summary report was 
generated. As indicated at the top of the screen, length of the current display is shown in seconds and 
length of the overall interval is shown in minutes. A "$" indicates that the end of the current rate bar 
equals the mean rate. 


All rates are rounded to the nearest integer, so a rate of less than 0.5 per second is not displayed. If no 
gray area appears, the rate for the current interval is less than 0.5 per second. If no white area appears, 
the current rate is also the maximum rate. 


The third section on the Memory Management Activity Display provides information about memory 
management special requests and memory management clock cycles. A special request is either a lock 
request or some form of segment expansion. A clock cycle occurs when the Memory Manager returns to 
the start of linked memory while attempting to make overlay candidates. Both of these events are 
measured by their current and overall rates per second. 


The percentage of special requests to the Memory Manager is also shown. Because of the relative in- 
frequency of these events, the current and overall rates per second are shown to the nearest two decimal 
places. 


interpretation Guidelines 


e Because the majority of special requests are for segment expansions, each such request normally 
requires one memory management I/O read and one memory management I/O write. 


e If the percentage of special requests is high (greater than ten percent), then either an excessive num- 
ber of special requests is occurring, or memory management requests are very few, which in turn 
makes the special request percentage high. 


e If the combined rate of memory management I/O reads and writes is high (greater than ten percent), 
then this may be an indication of memory pressure due to the current workload. If disc caching is 
enabled, you should also examine the memory management disc I/O rate. If rate greater than 5-10 
per second, then it is excessive. 


e If the combined rate of data, cache domains and code segment releases is high (greater than ten per 
second), then this may be an indication of memory pressure due to the current workload. 
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CPU/Memory Management Context (#C) 


Legend 


Memory Management Action 


Subdivides all memory allocation attempts (both during 


swap-ins and at the time of a fault) into five possible actions 
on a percentage bar. The total number of attempts appears 
_ to the right of each bar. 


The following five Memory Management actions are represented: 


R 


(RECOVERY ) 


(FREE SPACE) 


(OVERLAY CANDIDATE) 


(GIVE UP) 


(HARD REQUEST) 


Segment recovered from overlay candidate state, 


either at the time of a fault or during a process 


swap-in (i.e., no disc activity). 


Free space (available region) was found for the 
segment. 


_ One or more new overlay candidates were made. 


The attempt was postponed for one of the reasons 
below: . 


e More urgent pending activity. 


e The clock cycle rate for the clock algorithm 
exceeded the threshold value. 


A hard request was used to satisfy the request. If 
a memory allocation fails, for the highest priority 
process in the dispatch queue due to excessive 
memory contention, a hard request is issued to 
force the segment into memory. 
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The Memory Context provides detailed information on the system’s use of main memory. This context 
can be accessed from any context by entering “#M" between display updates, or whenever OPT/3000 is 
accepting commands. 
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Figure 7-1. - Memory Context 




























Eight displays and one menu of commands are available in this context. They are: 
(2? ) Menu of Commands - Memory Context 
(R ) Memory Report Display 
(M ) Memory Contents Display 
(B ) Bank Contents Display 
(O ) Overall Histogram Display 
(C ) Code Segment Size Histogram Display 
(D ) Data Segment Size Histogram Display 
(S ) Stack Segment Size Histogram Display 


(F ) Free Area Size Histogram Display 


1 


Memory Context (#M) 


The Memory Report, Memory Contents, and Bank Contents Displays are layered, so that each display 
provides more detailed information than the previous display. The Memory Report provides global in- 
formation about the utilization and contents of main memory, and is the default display for this context. 
The Memory Contents Display provides more detailed information about the current contents of memory, 
and the Bank Contents Display breaks the contents of memory down even further into individual banks of 
memory (64K words) and their current contents. 


The Overall Histogram Display and the three segment size histogram displays are layered in a similar 
fashion. The Overall Histogram Display indicates the distributions of segment sizes for code, stack, and 
data segments, while the individual segment size histogram displays provide higher resolution distributions 
for each individual type of segment. 


| Upon entering the Memory Context, OPT/3000 prompts you for the context display you wish to see with: 


ENTER COMMAND FOR DISPLAY (? FOR MENU); 
If you enter an unprogrammed command, or (RETURN), the Memory Report is generated by default. 


If you choose the Menu (?) you can obtain a menu screen of display options and all the Display Control 
Commands within us context. ae Figure 7-2. 
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Figure 7-2. Menu of Commands - Memory Display Context 
The display will prompt you with: 
COMMAND? 


Responding with an unprogrammed command (or a (RETURN) will generate this context’s default display. 
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MEMORY REPORT DISPLAY (R) 


The Memory Report Display is the default display for the Memory Context. It is accessed by entering "R" 
from within the Memory Context. 
MEMORY REPORT. DISPLAY 64 BANKS: 4131328 WORDS OF LINKED MEMORY 9:41 AM 
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Figure 7-3. Memory Report Display 


This display provides information about current memory contents and utilization. The Memory Report 
Display provides a global overview of current memory contents and is less detailed than the Memory 
Contents or Bank Contents Displays. 


Display Description 

The display divides memory usage into five categories: all of memory, linked memory, code segments, 

stack segments, and extra data segments. Each of these categories is further divided into subcategories, 

and the percentage of subcategory is indicated, rounded to the nearest two percent. The number of 

memory banks and the size of linked memory (in words) are shown at the top of the screen. 

Interpretation Guidelines 

e Ifa high percentage of linked memory is locked, frozen, or I/O-frozen, the Memory Manager may 
have difficulty finding a place in memory for large segments, depending upon the location of the 


frozen segments. 


e If the amount of memory occupied by a particular type of segment is small (e.g., extra data segments), 
then the breakdown of segment usage for that category is not of major importance. 
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Memory Context (4M) 


Legend 


ALL MEMORY - 100% represents all configured main memory. The unhighlighted portion of memory is 


freespace. 


(M) Memory Resident MPE 


(C) Code Segments 
(S) Stack Segments 


(D) Extra Data Segments 


(X) Cache Domains 


Memory permanently allocated to MPE for system tables 
and system code. ; 


Linked memory that currently contains code segments. 
Linked memory that currently contains stack segments. 


Linked memory that currently contains data segments, ex- 
cluding stacks. 


Linked memory that currently contains cached disc 
domains. 


LINKED MEMORY - 100% represents all memory except memory resident MPE. 


(A) Active Segments 


(0) Overlay Candidates 


(F) Frozen, Locked, and 
1/O frozen 


Segments that have been recently referenced. 


Segments selected by Memory Manager for possible removal 
from memory. 


Segments that cannot be removed from memory by the 
Memory Manager. 


Code and Data segments are categorized by usage and by source. The top part of the bar shows what per- 
centage of the segments in memory are user segments and what percentage are system segments. The bot- 
tom portion of the bar indicates the source of the segment. 


CODE SEGMENTS - 100% represents all memory occupied by code segments 


USAGE 
(U) User Segments 


(S) System Segments 


SOURCE 
(P) Program File 


(C) CST Segments 


Segments not marked as system segments. 


Segments marked as system segments. 


Segments from a program file. 


Segments from a system, account, or group segment library 
(SL). 


STACK SEGMENTS - 100% represents all memory occupied by stack segments. | 
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(U) User Segments Segments not marked as system segments. 


(S) System Segments Segments marked as system segments. 


EXTRA DATA SEGMENTS - 100% represents all memory occupied by data segments that are not stacks. 


USAGE 
(U) User Segments Segments not marked as system segments. 
(S) System Segments Segments marked as system segments. 
SOURCE 
(N) Non-special Extra data segments whose usage could not be determined. 
(F) File System Extra data segments obtained by the file system. 
(J) Job Management Extra data segments obtained by the system for information 
related to sessions and jobs. 
(I) IMAGE /3000 Extra data segments obtained by IMAGE/ 3000. 
(K) KSAM/3000 Extra data segments obtained by KSAM/3000. 
(T) System Tables Extra data segments containing MPE tables that do not 


reside in memory resident MPE. 
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LINKED MEMORY STATISTICS (ACTIVE) OVERLAY CANDIDATE STATISTICS 
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# LOCKED SEGMENTS: 0 % OF MEMORY: 21.1% % OF MEMORY: 1.6% 


Figure 7-4. Memory Contents Display 


To access the Memory Contents Display, enter '"M'’ from anywhere within the Memory Context while 
OPT/ 3000 is accepting commands. 


This display generates an image of the current contents of each bank of main memory, and provides sum- 
mary statistics about memory contents. The display provides a more detailed look at memory than does 
the Memory Report Display, but provides less detail on current memory than does the Bank Contents 
Display. 


The Memory Contents Display requires a minimum of 8K terminal display memory. Insufficient display 
memory generates the following message: 





Replying ''NO" updates the previous display. 
A maximum of 16 banks (2MB) can be displayed on a screen at one time. Each time the screen is updated 


the next 16 banks are displayed. If you want to keep the same set of 16 banks in the display, enter K. To 
see the next 16 banks, enter a K a second time. 
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Display Description 

The Memory Contents Display can consist of up to 16 lines, where each line represents one bank (64K 
words) of memory. Each character position represents approximately 1 K words of memory. Note that 
each individual segment is shown in either inverse video or inverse video half-bright. As with the Bank 
Contents Display, the color has no significance other than to distinguish between adjacent segments. Free 
areas are not explicitly shown. 

The right side and bottom of the screen are used to display the summary statistics. To the right, the per- 


centage of linked memory within a bank occupied by active segments is indicated for each bank of 
memory. An active segment is any segment that is not an overlay candidate. 


NOTE 


Percentages displayed on the right do not necessarily correspond to the 
length of the line since some character positions can represent segments of 
less than 1K memory. The restriction on the size of a character position 
limit the data that can be graphed. The numerical values are the most 
accurate. 
The bottom of the display provides the following statistics for all of memory: 
e Number of active segments 
e Number of frozen and I/O-frozen segments 
e Number of locked segments 
e Number of overlay candidates 
e Total size of all active segments (words) 
e Total size of all overlay candidates (words) 
e Percentage of linked memory occupied by active segments: 
e Percentage of linked memory occupied by overlay candidates 
The summary statistics provided in the hard copy of the Memory Contents Display are slightly different 
from those shown on your terminal. In addition to the percentage of active memory in each bank, the 
number of segments, and the percentage of linked memory occupied by each of the following categories 


are provided: 


e Stacks 


Mapped cache domains 


Unmapped cache domains 
e Code segments from segmented libraries (CST) 


e Code segments from program files (CSTX) 


feet 


Memory Context (4M) 


e System table data segments 

e File system data segments | 

e Job management data segments 
e IMAGE/3000 data avanti 

e KSAM/3000 data segments 

e Data segments (usage unknown) 
e Active segments 

e Overlay candidates 


e Frozen, locked, and I/O-frozen data segments 


Interpretation Guidelines 

e Frozen segments (blinking) in the middle of a bank cause problems for the Memory Manager. 
I/O-frozen segments typically remain in that state for only one or two display updates. Segments 
which blink for long periods of time are most likely frozen. 


e Locked segments are near bank boundaries. 


e A segment "changes color" if the number of segments preceding it in the bank have changed. A 
change of color does not signify change in the usage or status of the segment. 


e Keep in mind that an individual segment can be both swapped into memory and swapped out of 
memory between display updates. This display does not provide a complete history of the contents of 
memory. 


Legend 


The number of characters used to represent a segment is determined by the following steps. The region or 
subregion headers are included in this calculation. 


e The size of the segment is rounded to the nearest multiple of 1 K (1024) words. 

e The number of character positions is the number of 1K blocks in the rounded segment size. 

Because all segments use at least one character position, it is possible that more than 64 characters are 
required to represent the contents of a bank. The numbers which appear along the top of the display do 
not indicate the starting position of a segment within a bank, but rather are supplied to help you deter- 


mine the aUPron at size of a segment. The memory-resident portion of MPE is indicated in the line for 
bank zero. 
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The usage of each segment can be determined from the display by the letter appearing in the area 
representing the segment as follows: 

C - Code segment from system, ee: or group segmented library (SL) 

D -Extra data segment (usage unknown) 

F - File system data segment 

I - IMAGE/3000 data segment 

J  - Job management data segment 

K -KSAM/3000 data segment 

P= Code segment from program file 

S - Stack 

T - System table data segment 

X - Cache Domain 
A segment is further qualified by the following: 

Lowercase letter - System segment or unmapped cache domain 

Upper case letter - User segment or mapped cache domain 

Underlining - Segment is overlay candidate 


Blinking - Segment is locked, frozen, or I/O frozen 
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BANK CONTENTS DISPLAY (B) 
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EACH CHARACTER 

POSITION REPRESENTS 
64 WORDS OF MEMORY 
(1K= 16 POSITIONS) 


SEGMENTS TOO SMALL TO DISPLAY (ADDRESS,TYPE,SIZE) 





Figure 7-5. Bank Contents Display 


The Bank Contents Display is accessed by entering "B" from anywhere within the Memory Context 
whenever OPT/3000 is accepting commands. 


This display generates an image of the current contents of one bank (64K words) of main memory and al- 
lows you to determine the size, location and usage of each segment, and all free areas of memory in this 
particular bank. In addition, this display provides several summary statistics about the contents of each 
bank. Notice that the bank numbers are octal and zero relative. 


A minimum of 8K terminal display memory is required. If your terminal is equipped with less display 
memory, you receive the following warning message: 


THIS TERMINAL HAS INSUFFICIENT DISPLAY MEMORY TO 
COMPLETELY DISPLAY A SINGLE BANK. A MINIMUM OF 8K 
MEMORY IS REQUIRED FOR THE FULL DISPLAY. 

DO YOU WISH TO TRY ANYWAY? 


"NO" reply updates the previous display. "YES" generates the display, but you will have difficulty inter- 
preting it because the terminal deletes lines from the screen to make room for new display characters 


when it reaches its display capacity. Therefore, the form of the resulting display is unpredictable. 


Replying "YES" to the question above, or upon requesting this display with the correct minimum terminal 
memory size, you are prompted by: . 


ENTER THE NUMBER OF BANK TO BE DISPLAYED (OCTAL): 


Memory Context (4M) 


If your response is not an octal integer, the message 
BANK NUMBER MUST CONSIST OF OCTAL DIGITS 


is displayed, and you will be prompted again for an octal number. Once you have entered an octal in- 
teger, OPT/3000 checks to ensure it is a valid bank number. If it is invalid, the following appears: 


BANK NUMBER MUST BE BETWEEN O AND X 
where X represents the number of banks in your memory configuration. You are then prompted to enter 
another bank number. 
Display Description 


The numbers at the left margin and top reference segment addresses; those at the left are the most sig- 
nificant numbers and those at the top are the least significant. 


Each Bank Contents Display consists of 16 lines with room for 64 (77 octal) characters in each line. Each 
character position represents 64 words of memory, allowing for representation of 4096 memory words per 
line. Each segment in the display is shown in either inverse video full-bright (white) or inverse video 
half-bright (gray). The color has no significance in the bank displays other than to distinguish between 
adjacent segments. Free areas are represented by dark (blank) areas. 
OPT/3000 internally rounds segments to the nearest multiple of 64 words, and segments smaller than 64 
words do not appear in the main display, but rather appear at the bottom of the display in the section 
labeled “SEGMENTS TOO SMALL TO DISPLAY". The starting address, segment type, and segment size (in 
words) are indicated for each segment in this section. Information for up to 12 segments can be provided 
in this area. 
The far right side of the screen provides summary statistics for the bank under examination. For each of 
eight categories, statistics detail the number of segments or areas in the category and the percentage of 
linked memory within the bank occupied by segments in that category. The categories for which summary 
statistics are provided include: 

Active segments - (not marked as overlay candidates) 

Free areas 

Overlay candidates 

Code segments 

Stack segments 

Extra data segments (not including stacks) 


Cache domains 


Frozen, locked, and I/O-frozen segments 


ii 


Memory Context (4M) 


A hard copy of the Bank Contents Display provides the following additional categories: 
Active segments 
Overlay candidates 
Code segments from segmented libraries (SL) 
Code segments from program files 
Stacks 
File system data segments 
IMAGE/3000 data segments 
KSAM/3000 data segments 
Job management data segments 
System table data segments 
Data segments (usage unknown) 
Frozen, locked, and I/O-frozen data segments 
Free areas 
Mapped Cache domains 


Unmapped cache domains 


Interpretation Guidelines 
e A single segment (or free area) may span more than one line of the display. 


e All guidelines listed for the Memory Contents Display also apply to this display. 


Memory Context (#M) 


Legend 
The type of each segment appearing on the display is determined from the letter printed on the bar. Lack 
of space precludes a Legend section on this screen, so the following information is only available in this 
manual and from the Help (H) command: 
| R - MPE memory resident segment 

C - Code segment from system, account, or group segmented library (SL) 

_ D - Extra data segment (usage unknown) 

F ~ File system data segment 

I - IMAGE/3000 data segment 

J - Job management data segment 

K - KSAM/3000 data segment 

P - Code segment from program file 

S - Stack 

T - System table data segment 

X - Cached disc domains 
In addition, the segment is qualified in the following way: 

Lowercase letter - System segment or unmapped cache domain 

Upper case letter - User segment or mapped cache domain 

Underlining _ = Segment is overlay candidate 

Blinking - Segment is locked, frozen, or I/O frozen 
As mentioned in the Display Description section, each character position represents 64 words. The num- 
ber of characters used to represent a segment is determined not by the size of the segment, but rather by 
the location of the start and end of the segment within the bank. The region and subregion headers or 
free space preceding the segment are considered part of the segment when these calculations are perform- 
ed. The number of character positions used to represent an area is determined as follows: 


e The start and end addresses of the area are rounded to the nearest multiple of 64. 


e The number of character positions required is the number of 64-word blocks between the rounded 
start and end addresses. 


e If the rounded start and end addresses are identical, (possible if the segment is smaller than 64 words), 
the segment is not shown in the primary display, but is listed in the “SEGMENTS TOO SMALL TO 
DISPLAY" area of your screen. 


Memory Context (#M) 
OVERALL HISTOGRAM DISPLAY (0) 


The Overall Histogram Display is accessed by entering "O" from anywhere in the Memory Context when 
ORL 3000 is accepting commands. 
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Figure 7-6. Overall Histogram Display 


This display is the highest level histogram display available and provides frequency distribution bars and 
summary statistics for code, stack, and extra data segment sizes. Depending on user input of additional 
commands (explained at the end of Memory Context Section), segments actually included in the display 
vary. 


Display Description 


The display is divided into four sections, one for each of the three histograms, and one for the summary 
statistics. The line drawing character set on your terminal produces the histograms. The horizontal axis 
represents the segment size in 1K word increments, so that the first column includes all segments between 
0 and 1K words, the second column includes all segments between 1K and 2K words, and so on. The 
height of the column indicates the frequency count or the number of segments of a given size. All counts 
are rounded up to the nearest multiple of two, so counts of 1 and 2, for example, are indistinguishable. 
The line drawing character set allows a resolution of three units per character position, so mest maximum 
frequency count that can be represented is 48. 
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interpretation Guidelines — 
e Frequency counts greater than 48 are truncated to 48. 


e The tick marks and labels on the vertical axis are aligned with the middle of a character position, not 
the top of the position. . 


e The "A" additional command includes absent segments (such as data segments in virtual memory) in 
addition to the segments in main memory. 


e If the distributions indicate a significant number of large segments (greater than 10K), then the 
memory manager may have difficulty satisfying requests for absent segments. 


Legend 

Four statistics are reported on each of the three histograms: 

e The number of segments included in the histogram. 

e The mean size (number of words) of all segments included in the histogram. 
e The largest segment size (number of words) included in the histogram. 


e The number of segments included in the histogram which are currently in memory (present). 


wienions Context (4M) 
CODE SEGMENT SIZE HISTOGRAM DISPLAY (C) 


The Code Segment Size Histogram Display is one of three segment histograms that make up the Overall 
Histogram Display. It uses higher resolution than the overall histogram, and describes distribution more 
precisely. Use it when the maximum frequency count of 48 has been reached on the code segment por- 
tion of the Overall Histogram Display. (You can, however, access it from any display in the Memory 
Context by entering "C" while OPT/3000 is accepting commands). 
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Figure 7-7. Code Segment Size Histogram Display 


The Code Segment Size Histogram Display generates a histogram describing the distribution of code seg- 
ment sizes and provides summary statistics about the code segments included in the histogram. The seg- 
ments included in this display also depend.on the histogram additional commands you choose. 


This histogram provides more detail than that of the Overall Histogram Display by utilizing the poponane 
enhancements: 


e The horizontal axis uses 512 word increments instead of 1K word increments. 


e The frequency counts are not rounded, making it possible to determine exactly the number of seg- 
ments of a particular size. 


e The maximum frequency count is 60 instead of 48. 


Memory Context (#M) 


Display Description 

The display is a histogram that represents distribution of segment sizes in 512-word (1/2KW) increments 
along the horizontal axis, and a frequency count of the number of segments of a particular size along the 
vertical axis. The maximum displayable frequency count on the screen is 60, but the maximum frequency 
count displayed on hard copy is 54. 

The horizontal axis is labeled "1 K words’ just as the horizontal axis is labeled on the Overall Histogram. 
The space between increments, however, is doubled, so that there are eight character spaces between 0 and 
4 on the display above. 

Interpretation Guidelines 


e The tick marks and labels on the vertical axis are aligned with the middle of a character position, not 
the top of the position. 


e The "A" additional command includes absent segments (such as data segments in virtual memory) in 
addition to the segments in main memory. 


Legend 

Four summary statistics are reported: 

e The number of segments included in the histogram. 

e The mean size of the segments (number of words). 

e The size (in words) of the largest segment included in the histogram. 


e The number of segments included in the histogram that are currently in memory (present). 


Memory Context (4M) 
DATA SEGMENT SIZE HISTOGRAM DISPLAY (D) 


The Data Segment Size Histogram Display is one of three segment histograms that make up the Overall 
Histogram Display. This display expands upon the information presented in the Overall Histogram and 
more precisely describes the distribution by using a higher resolution. You will want to reference this dis- 
play when the maximum frequency count of 48 has been reached on the data segment portion of the 
Overall Histogram. To access this display, enter "D' from anywhere within the Memory Context while 
OPT/3000 is accepting commands. 
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Figure 7-8. Data Segment Size Histogram Display 


This Data Segment Size Display generates a histogram that describes the distribution of data segment sizes, 
excluding stacks. The segments included in this display are also dependent upon the histogram options 
you choose. Summary statistics about the segments included on your display will appear to the right of 
your screen. 


Display Description 


The display represents the segment size in $12 word (1/2KW) increments along the horizontal axis, and 
provides a frequency count of the number of segments of a particular size along the vertical axis. The 
frequency count is not rounded as it is in the overall histogram. The maximum displayable frequency 
count is 60. If the count is higher, it is truncated to 60. Note that the maximum displayable frequency 
count on hard copy is 54. 


Memory Context (#M) 


Interpretation Guidelines 


e The tick marks and labels on the vertical axis are aligned with the middle of a character position, not 
the top of the position. 


e The "A" additional command includes absent segments (such as data segments in virtual memory) in 
addition to the segments in main memory. 


Legend 
The following four summary statistics are reported for the data segments in this display: 


e The number of segments included in the histogram. 


The mean size (number of words) of all segments included in this display. 


The largest segment size (number of words) included in the histogram. 


The number of segments included in the histogram that are currently in memory (present). 


Memory Context (4M) 
STACK SEGMENT HISTOGRAM DISPLAY (S) 


The Stack Segment Histogram gives a more detailed view of stack size distribution than on the Overall 
Histogram. You should access this display if the maximum frequency count of 48 is reached on the stack 
segment portion of the Overall Histogram. You can access this display by entering "S" from anywhere 
within the Memory Context whenever OPT/3000 is accepting commands. 
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Figure 7-9. Stack Segment Size Histogram Display 


This display generates a histogram describing the distribution of stack segment sizes and provides summary 
statistics about the stack segments included in the histogram. The stack segments displayed depend on the 
histogram options you specify. 


Display Description 


The display is a histogram that shows the distribution of stack size in 512-word (1/2KW) increments 
along the horizontal axis, and a frequency count of the number of segments of a particular size along the 
vertical axis. The frequency count is not rounded as it is in the Overall Histogram. The maximum 
frequency count that can be displayed for this histogram is 60. If the count is higher, it is truncated to 
60. The maximum frequency count that can be displayed on a hard copy is 54. 


Memory Context (4M) 


Interpretation Guidelines 


e The tick marks and labels on the vertical axis are aligned with the middle of a character position, not 
the top of the position. 


e The "A" additional command includes absent segments (such as data segments in virtual memory) in 
addition to the segments in main memory. 


Legend 

Four summary statistics are reported on your display screen for stack segments: 

e The number of segments included in the histogram. 

e The mean size (number of words) of all stack segments included in the histogram. 
e The largest stack segment size (number of words) included in the histogram. 


e The number of stack segments included in the histogram that are currently in memory (present). 
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Memory Context (4M) 
FREE AREA HISTOGRAM DISPLAY (F) 


This histogram displays the distribution and frequency of free areas within linked memory. This display 
is accessed by entering "F" from anywhere within the Memory Context whenever OPT/3000 is accepting 
commands. Note that the additional commands do not apply to the Free Area Size Histogram. 
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Figure 7-10. Free Area Size Histogram Display 


Display Description 
The horizontal axis measures free area size in increments of 1K words and the vertical axis provides a 


frequency count of free areas. The maximum displayable frequency count is 60. The maximum frequen- 
cy count that can be displayed on hard copy is 54. 


Interpretation Guidelines 


The tick marks and labels on the vertical axis are aligned with the middle of a character position, not the 
top of the position. 
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Memory Context (#M) 


Legend 

Three statistics are reported for the Free Area Histogram: 

e The number of free areas included in the histogram. 

e The mean size (words) of all free areas included in the histogram. 
e The largest free area size (words) included in the histogram. 


Note that the number in memory statistic is not reported for this histogram since all free areas of memory 
are present. 
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Memory Context (#M) 


ADDITIONAL COMMANDS 


The histogram additional commands allow selection of segments to display on the various histograms. 
These commands are useable within the overall and individual histogram displays, except the Free Area 
Display. The additional commands are: 


A - Include all segments (including those absent from main memory). 
P - Include only present segments (default). 

U - Include only user segments. 

N - Include only non-user (system) segments. 


With the exception of the "A" additional command, the commands currently in effect are indicated in a 


box in the statistics section of the screen. The "P" (present) command is automatically in effect upon en- 
tering the Memory Context. If the current display is not a histogram, entering a histogram command will 
only update the current display, but the specified histogram command will take effect upon returning to 
any histogram display. 

Additional commands can be utilized simultaneously. For example, to look at present user segments enter 
both the "P" and "U" commands, one at a time. This enables both commands simultaneously. Any com- 
mands specified remain in effect until either the Memory Context is exited, or another command is 


specified that overrides the first. For example, the "U" Command overrides the "N" Command, and vice 
versa. The "A" Command cancels any other command that is in effect. 


NOTE 


Segments in memory-resident MPE are not considered in any histogram. 
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Memory Context (#M) 


All Segment Histogram (A) 

Under this histogram additional command, all segments known to MPE are included in the histograms, in- 
cluding those not currently in main memory. This command cancels the effect of the Non-User Only (N), 
Present Only (P), and User Only (U) commands. This command is not highlighted on your screen as are the 
other three histogram commands. see Stee 
Non-User Segment Only Histogram (N) 

Using this additional command causes the histogram to display only those segments marked as system seg- 
ments. This command cancels the effect of the User Only (U) command. 

Present Segment Histogram (P) 

This additional command allows only present main memory segments to be included in the histogram. It 
is the default command under Memory Context. =e 

User Segment Only Histogram (U) 

This additional command allows only those segments not marked as system segments to appear in the his- 
tograms. This command cancels the effect of the Non-User Only (N) Histogram. Figures 7-11, 7-12, 
7-13, and 7-14 illustrate the effect of the "U" command on the various histograms on which this com- 
mand is available. 

Keep Current Memory Block (K) 

This command isa toggle. The first time you enter K, the current 16 banks are redisplayed. The next 16 


banks are not displayed. The next time you enter K, the next 16 banks are displayed, replacing the cur- 
rent 16 banks. 
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Memory Context (#M) 
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Figure 7-12. 
Code Segment Size Histogram Display (user segments) 
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Memory Context (#M) 
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Figure 7-14. 
Stack Segment Size Histogram Display (user segments) 
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SECTION 


1/O CONTEXT (#l) 





The I/O Contexts measures the input and/or output rates of the disc, printer, and tape devices. This con- 
text can be accessed from any context by entering "#I" between display updates or whenever OPT/3000 
accepts commands. 


OPT/3000 
CONTEXTS 


GLOBAL CPU-MEMORY MEMORY “Uo PROCESS SYSTEM 
CONTEXT MANAGER CONTEX Context ail et ae CONTEX 
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Figure 8-1. Command Structure Diagram - I/O Context 
Four displays and one menu of commands are available in this context. They are: 
(7?) Menu of Commands - I/O Context 
(R) I/O Activity Report Display (default) 
(D) Disc Activity Display 
(P) Line Printer Activity Display 
(M) Magnetic Tape Activity Display 
Upon entering the I/O Context, OPT/3000 prompts you for the context display you wish to see with: 
ENTER COMMAND FOR DISPLAY (? FOR MENU) 


Responding with an unprogrammed command (or a RETURN) generates this context’s default display. 
Entering "2" produces a menu display option within this context. This is illustrated in Figure 8-2. 
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I/O Context (#1) 
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“ee DISPLAYS #4 


: | #**CONTROL OPERATIONS#4# 
D DISC ACTIVITY 


#A ALTER LINE DRAWING CHAR SET POSITION 
#C ENTER CPU-MEMORY MANAGER CONTEXT 
#G ENTER GLOBAL CONTEXT 

#H CONTINUOUS HARD COPY GENERATION 

#1 ENTER 1/0 CONTEXT 

#L CLOSE LISTING FILE 

#M ENTER MEMORY CONTEXT 

#P ENTER PROCESS CONTEXT 

§S SUSPEND OPT (UNTIL USER INPUT) 

#T ENTER SYSTEM TABLES CONTEXT 

#2 MENU OF CONTROL OPERATION COMMANDS 


M MAGNETIC TAPE ACTIVITY 
P LINE PRINTER ACTIVITY 


R I/O ACTIVITY REPORT (default) 





| *¥#OTHER COMNANDS### 
A ALTER DISPLAYED DEVICES 










@ DISPLAY DISC QUEUE INFO 
(only one dise will be 


displayed at a time.) € EXIT 


H HELP 

L LISTING (GENERATE HARD COPY) 

T TIME CHANGE (OF UPDATE INTERVAL) 
X DEFINE XEQ SEQUENCE 


 MPE COMMAND 
? MENU DISPLAY 


4 NOTE COMMAND 


N DISPLAY NEXT DEVICES 





Figure 8-2. Menu of Commands - I/O Display Context 
Responding to the menu prompt: 


COMMANDS ? 


with an unprogrammed character (or a (RETURN) generates this context’s default display. 
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1/O Context (#1) 
1/O ACTIVITY REPORT DISPLAY (R) 


This display provides summary information about I/O activity on the discs, line printers, and magnetic 
tape drives. Information is reported for all devices for both the current sampling interval and since the 
last summary report was generated. To access this display, enter "R' from anywhere within the I/O 
Context whenever OPT/3000 is accepting commands. This is the default display for the I/O Context. 
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Figure 8-3. I/O Activity Report 


Display Description 


The I/O Activity report shows the I/O completion rates per second for disc, tape, and printer. All I/O 
rates and counts represent physical activity not logical disc activity that was handled by MPE disc cach- 
ing. The bars on the first section of your screen indicate I/O completion rates per second for each of the 
three device types during the current sampling interval. The second section of the screen indicates the 
number of completed I/O’s per second over all intervals since the last summary report was generated. The 
rate bars further subdivide disc I/O’s into cached I/O, user I/O and Segment Manager I/O, these are 
represented by ''X", "“U", and "S", respectively. 


A rate of less than 0.5 per second is not displayed. The disc activity is also shown to the right of the bar 
in the form (user I/O rate / segment manager I/O rate / cached I/O rate.) 
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I/O Context (#1 


Interpretation Guidelines 
e Each I/O completed for line printer roughly corresponds to one line printed. 


e AllI/O rates and counts represent physical disc activity, not logical disc activity that was handled by 
MPE disc caching. 


Legend 

For each of the device types, the following types of I/O are included in the completion rates: 
Disc - Read, write, and control operations. 
Line Printer - Write and control operations. 
Magnetic Tape ~ Read, write, and control operations. 


Three types of I/O are indicated on the disc bars: 
CACHED I/O (Xx) = Disc I/O completed for cached I/O. 
USER (U) - Disc I/O completed on the behalf of a user or system process. 


SEGMENT MANAGER (S)_  - Disc I/O completed for segment management. 
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DISC ACTIVITY DISPLAY (D) 


I/O Context (#1) 


The Disc Activity Display provides performance information about disc I/O for both the current interval 
and since a summary report was last generated. To access this display, enter "D' from anywhere within 
the I/O Context whenever OPT/3000 is accepting commands. 
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Figure 8-4. Disc Activity Display 


Activity is monitored for all discs combined, and for each individual disc. Due to space limitations on 
your terminal screen, information can be provided for no more than four individual discs at one time. If 
your system has more than four disc devices configured, the following message is displayed when you 


request the Disc Activity Display: 


AT MOST FOUR DEVICES CAN BE DISPLAYED SIMULTANEOUSLY. 
SELECT FOUR DEVICES FROM THE FOLLOWING LIST: 


LOGICAL DEVICE x1 
LOGICAL DEVICE x2 
LOGICAL DEVICE x3 
LOGICAL DEVICE x4 


a WD = 


N LOGICAL DEVICE xn 


DEVICES TO BE DISPLAYED? 


g=5 


1/O Context (#1) 


You should respond by entering four integers between 1 and N, separated by commas, corresponding to the 
individual devices you want to observe. If any of your responses are notin the 1 to N range, the message: 


‘2’ IS NOT IN THE RANGE 1 TON 


is displayed, and the prompt repeated. If you enter fewer than four integers, only those devices chosen are 
displayed. If you enter the same device twice, the second input is ignored, and if more than four responses 
are given, OPT/3000 accepts only the first four different devices of your response. For example, if you 
respond with an input of 1,2,1,3,4, the devices displayed are 1, 2, 3,and 4. A will display the first 
four devices and more devices when you type "N". If only one device is requested, the queue length infor- 
mation for that device is also displayed. 


Display Description 


This display consists of rate per second bars that measure combined disc activity and also four individual 
discs at atime. The bar measuring all disc devices may include some devices for which no individual rate 
bar is shown. | 


The top half of each bar measures current disc I/O activity and the bottom half of each bar measures 
overall activity since a summary report was last generated. Each measurement bar of each disc monitored 
is further broken down by function: 


Read Operations 

Write Operations 

Control Operations (non-read, non-write I/O) 
The three actual rates also appear in parentheses to the right of the bar in the form (read-rate / write- 
rate / control-rate). Alli rates are rounded to the nearest integer, so a rate of less than 0.5 per second is 
not displayed. 
The bottom portion of the display provides the maximum observed rate per second for each type of I/O 
operation (read, write, control) for each device and all devices combined. Here, maximum rates include 
both user and memory management I/O operations and appear in the form (user maximum / memory 


management maximum). These rates indicate the highest rate observed during any interval since the last 
summary report was generated. 
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I/O Context (#I) 


Interpretation Guidelines 


e If the disc I/O’s are not evenly distributed over the different discs on the system, it may be possible to 
decrease disc contention by spreading the files more effectively. 


e If more than four disc devices are configured, the all disc rate bar may include individual disc not 
shown in the display. 


e All I/O rates and counts represent physical disc activity, not logical disc activity that was handled by 
MPE disc caching. 


e Heavy use of just one disc on a multiple disc system MAY mean that just one file or application is 
causing the disc activity. 


Legend 
Three types of disc I/O operations are detailed: 
R (READ) - A read operation 
W (WRITE) - A write operation 
C (CONTROL) ~ Neither a read nor a write (for example, a file open) 


Each rate bar is labeled with its appropriate ldev number. 
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I/O Context (#1) 


MAGNETIC TAPE ACTIVITY DISPLAY (M) 


The Magnetic Tape Display provides data on I/O performed by tape(s). Tape activity is displayed for both 
the current sampling interval and since a summary report was last generated. To access this display, enter 
"M" from anywhere within I/O Context whenever OPT/3000 is accepting commands. 
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Figure 8-5. Magnetic Tape Activity Display 


Activity is monitored for all tapes combined and for individual tapes. Due to space limitations on your 
terminal screen, information can be provided for no more than four individual tapes at one time. If more 
than four tape drives are configured, the following is displayed when you request Tape Activity Display: 


AT MOST FOUR DEVICES CAN BE DISPLAYED SIMULTANEOUSLY. 


SELECT FOUR DEVICES FROM THE FOLLOWING LIST: 


LOGICAL DEVICE x! 
LOGICAL DEVICE x2 
LOGICAL DEVICE x3 
LOGICAL DEVICE x4 


AWN — 


N LOGICAL DEVICE xn 


DEVICES TO BE DISPLAYED? 
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I/O Context (#1) 


You should respond by entering four integers between | and N, separated by commas, corresponding to the 
individual devices you want to observe. If any of your responses are not in the 1 to N range, the message: 


“Z’ IS NOT IN THE RANGE 1 TON 
is displayed and the prompt repeated. If you enter fewer than four integers, only those devices chosen are 
displayed. If you enter the same device twice, the second input is ignored and if more than four responses 
are given, OPT/3000 accepts only the first four different devices of your response. For example, if you 


respond with an input of 1,2,1,3,4, the devices displayed are 1, 2, 3, and 4. (QETURN) displays the first four 
devices and the rest of the devices when you type "N". 


Display Description 
This display consists of rate per second bars that measure combined tape activity and also four individual 
tapes at a time. The bar measuring all tape devices may include some devices for which no individual rate 
bar is shown. 
The top half of each bar measures current tape I/O and the bottom half of each bar measures overall ac- 
tivity since a summary report was last generated. Each measurement bar of each tape monitored is fur- 
ther broken down by function: 

Read Operations 

Write Operations 

Control Operations (non-read, non-write I/O) 
The actual rates will be indicated in parentheses to the right of the bar in the form (read-rate / write- 
rate / control rate). All rates are rounded to the nearest integer, so a rate of less than 0.5 per second is 
not displayed. 
The bottom portion of the display provides the maximum observed rate per second for each type of I/O 
operation (read, write, control) for each tape device and all tape devices combined. These rates indicate 
the highest rate observed during any interval since the last summary report was generated. 


Interpretation Guidelines 


e Asingle tape drive may be represented by four logical devices (units 0-3). If this is the case, they 
cannot all be in use simultaneously. 


e If more than four such devices are configured, the “all tapes" rate bar may include individual devices 
which are not shown in the display. 
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I/O Context (#1) 


Legend 


Three types of I/O operations are monitored: 
R (READ) - A read operation 
W (WRITE) - A write operation 
C (CONTROL) - Neither a read nor write (for example, a file open) 


I/O Context (#1) 


LINE PRINTER ACTIVITY DISPLAY (P) 


The Line Printer Activity Display provides line printer I/O data. Printer activity is displayed for the cur- 
rent interval and for all intervals since a summary report was last generated. To access this display, enter 
"Pp" from anywhere within the I/O Context whenever OPT/3000 is accepting commands. 
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- Figure 8-6. Line Printer Activity Display 


Activity is monitored for all printers combined and for individual printers. Due to space limitations on 
your terminal screen, information can be provided for no more than four individual printers at one time. 
If your system has more than four line printers configured, the following message is displayed when you 
request the Line Printer Activity Display: : . 


AT MOST FOUR DEVICES CAN BE DISPLAYED SIMULTANEOUSLY 
SELECT FOUR DEVICES FROM THE FOLLOWING LIST: 


LOGICAL DEVICE x1 
LOGICAL DEVICE x2 
LOGICAL DEVICE x3 
LOGICAL DEVICE x4 


bWNh 


N LOGICAL DEVICE xn 


DEVICES TO BE DISPLAYED? 
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I/O Context (#1) 


You should respond by entering four integers between 1 and N, separated by commas, corresponding to the 
individual devices you want to observe. If any of your responses are not in the | to N range, the message: 


“Z’ IS NOT IN THE RANGE 1 TO N 
is displayed and the prompt repeated. If you enter fewer than four integers, only those devices chosen are 
displayed. If you enter the same device twice, the second input is ignored. If you enter more than four 
responses, OPT/3000 accepts only the first four different devices. For example, if you respond with an 


input of 1,2,1,3,4, the devices displayed are 1, 2, 3, and 4. displays the first four devices and the 
rest of the devices when you type'"N”. 


Display Description 
This display consists of rate per second bars that measure combined line printer activity and also four in- 
dividual printers at a time. The bar measuring all printer devices may include some devices for which no 
individual rate bar is shown. 
The top half of each bar measures current printer I/O and the bottom half of each bar measures overall 
since a summary report was last generated. Each measurement bar of each printer shown is further 
broken down by function: | 

WRITE OPERATIONS 

CONTROL OPERATIONS (NON-READ, NON-WRITE I/O) 
The actual rates are also indicated in parentheses to the right of the bar in the form (write-rate / 
control-rate). All rates are rounded to the nearest integer, so a rate of less than 0.5 per second is not 
displayed. 
The bottom portion of the display provides the maximum observed rate per second for each type of I/O 
operation (write, control) for each device and all devices combined. These rates indicate the highest rate 
observed during any interval since the last summary report was generated. 


Interpretation Guidelines 


The "all LP" rate bar may include individual devices which are not shown in the display, if more than four 
such devices are configured. 


Legend 
Two types of I/O operations can be shown for the separate and combined line printers: 
W (WRITE) ~ A write operation 


C (CONTROL) - Neither a read nor a write (for example, a file open) 


I/O Context (#1) 
ADDITIONAL COMMANDS | 


In addition to the displays, three additional commands are available in this context. 


Alter Displayed Devices Command (A) 


This command is used to alter the list of individual devices you want displayed in the disc activity, line 
printer activity, and magnetic tape activity displays. This command can be accessed by entering "A" 
within a device activity display when more than four devices of any one type are configured. If fewer 
than four devices of any one type are configured, "A" is treated as a and your current display is 
updated. If the command is recognized, OPT/3000 gives you a list of the devices that are currently dis- 
played and a list of all devices of the type that are configured: 


CURRENT DEVICES DISPLAYED ARE: 


SLOT 1: LOGICAL DEVICE x1 
SLOT 2: LOGICAL DEVICE x2 
SLOT 3: LOGICAL DEVICE x3 
SLOT 4: LOGICAL DEVICE x4 


SELECT DEVICES FROM THE FOLLOWING LIST: 


1. LOGICAL DEVICE x1 
2 LOGICAL DEVICE xe 


N LOGICAL DEVICE xn 
DEVICES TO BE DISPLAYED? 


In response, enter four integers between 1 and n, separated by commas, indicating the four individual 
devices you wish displayed. If any of your responses are not in the 1-n range, the message: 


“Z’ IS NOT IN THE RANGE 1 TO N 


is displayed and the prompt repeated. If you specify fewer than four devices, only the specified devices 
are displayed. displays the first four devices. To display more devices, enter ''N". Once devices 
have been selected, OPT/3000 erases the dialog and updates the current display. 


Display Next Devices Command (N) 


This command is used in the disc activity, line printer activity and magnetic tape activity displays when 
more than four devices have been selected for display. Each time you enter '"N', the next “ur devices are 
displayed unless there are less than four devices still to be displayed. If so, the remaining devices are dis- 
played. The next display starts from the beginning of the list. If disc queue lengths are also currently 
being displayed, only one disc is displayed per screen. 


I/O Context (#1) 


Display Disc Queue Information Command (Q) 


This command is a toggle that enables or disables the display of queue length information. The informa- 
tion is displayed for one disc at a time. To display the queue length for the next disc drive, use the NEXT 


(N) command. The display shows the counts and the percentages for the current and the overall 
_ intervals. 


For each disc request completion, the number of disc requests queued for that device is sampled. The 
count fields indicate the number of the samples that found a queue length of 0, 1, 2,... 5, >=6, respective- 
ly. The percentages display these counts as a proportion of the total disc requests for the device. 


PROCESS CONTEXT (#P) 





The Process Context provides detailed information about process activity and usage of program files. This 


context can be accessed from any other context by entering "#P"' between display updates or whenever 
OPT/3000 accepts commands. 


Several displays contain more information (in list form) than is possible to illustrate on one screen. To 


view all available data, the "roll up" and "roll down" keys on the terminal should be used. These keys 
should not, however, be used while the current screen is updating. 


OPT/3000 
CONTEXTS 


GLOBAL CPU-MEMORY MEMORY “vo PROCESS. SYSTEI 
ad MANAGER CONTEX CONTEXT CONTEXT aa TABLES CONTEX 


CPU-MEMORY MEMORY REPOR REDO ACMI revs Tasi 
RESoURCE “USAGG oe DISPLAY MMAR Y UTLIZATION 
nero 
PROCESS poe BTM ao FLE } OETAILED TABLE 
SUMMARY - MANAGEMENT CONTENTS INFORMATION 
DISPLAY eat DISPLAY mae eee 
2 


CPU USAGE MAGNETIC PROGRAM FILE 
DISPLAY conTenirs TAPE ACTIVITY} USERS DISPLA 
caved ae 


| SS LINE PRINTER | PROCESS 
HISTOGRAM ACTIVITY DISPLAY 
| BS PISRLAY’ 


¢ 


oe SEGMENT 
STATE REPORT 
MOTOGRAM DISPLAY 
oe 
R 
Holle SEGMENT 
mSTOGRAM 
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| 
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Ss 


FREE AREA 
HISTOGRAM 





Figure 9-1. Process Context 


Five displays and a menu of commands are available within this context: 

(2?) Menu of Commands - Process Context 

(G) User Summary Display (Default) 

(F) Program File Display 

(U) Program File Users Display 

(P) Process Display 

(R) Process State Report Display 
The Program File Display, Program File Users Display, and Process Display are nested. Each display 
provides more detailed information than the preceding one. The Program File Users Display can only be 


generated after the Program File Display has been accessed and the Process Display can only be accessed 
from the Program File Users Display or the User Summary Report. 
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Process Context (#P) 


Upon entering the process context, OPT/3000 prompts you for the context display you wish to see with: 
ENTER COMMAND FOR DISPLAY (? FOR MENU): 


Entering a or an unprogrammed command will generate the User Summary Report display by 
default. . 


Entering "?" in Process Context, generates a menu of the display options within the Process Context and 
all the Display Control commands. (Figure 9-2.) Responding to the menu prompt: 


COMMANDS? 


with an unprogrammed command (or RETURN) generates this contexts default display. 
” MENU OF..COMMANDS --- PROCESS DISPLAY CONTEXT ##### 

















* 


*DISPLAYS*## 


DIST ***CONTROL OPERATIONS### 
(default) 


#A ALTER LINE DRAWING CHAR SET POSITION 
#C ENTER CPU-MEMORY MANAGER CONTEXT 
#G ENTER GLOBAL CONTEXT 

#H CONTINUOUS HARD COPY GENERATION 

#I ENTER I/O CONTEXT 

#L CLOSE LISTING FILE 

#M ENTER MEMORY CONTEXT 

#P ENTER PROCESS CONTEXT 

#S SUSPEND OPT (UNTIL USER INPUT) 

#T ENTER SYSTEM TABLES CONTEXT 

#2? MENU OF CONTROL OPERATION COMMANDS 


f PROGRAM FILE 


ii PROGRAM FILE USERS 


P PROCESS 


R&R PROCESS STATE REPORT 









A LIST ALL PROCESSES IN USER SUMMARY 
B PAGING ON/OFF 
© LIST CPU ACTIVE PROCESSES ONLY 
D LIST PROCESSES BY USER ACCOUNT 
T IN USE ONLY (F display) 
N NEXT (used with P and U display) 
Wy LIST WORKING SET SEGMENTS 
(used with P and U displays) 
M LIST STACK MARKERS (P display) 





E EXIT 
H HELP 

kL LISTING (GENERATE HARD COPY) 

| TIME CHANGE (OF UPDATE INTERVAL) 
X DEFINE XEQ SEQUENCE 

= MPE COMMAND 

? MENU DISPLAY | 

* NOTE COMMAND COMMAND? 


Figure 9-2. Menu of Commands - Process Display Context 
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Process Context (#P) 
SECURITY RESTRICTIONS 


Some Process Context displays are subject to the following security restrictions: 

(a) Process Display 

To obtain access to the Process Display, you must have at least one of the following attributes: 
SM Soca 
OP capability 


AM capability for the account in which the program file being executed by the process in question is 
stored 


Creator of the program file being executed by the process in question 
For example, if the program file being executed by the process is CAT.CARRI. USERS, the only users be- 
sides those with SM or OP capability that can generate a Process Display are the creator of 
CAT.CARRI. USERS and the USERS Account Manager. 
(b) Program File Users Display — 
You must have at least one of the following attributes to gain access to the Program File Users Display: 
SM capability 
OP capability 
AM capability for the account under which the program file is stored 
Creator of the program file in question 
Logged on under the same group account as the program file in question UNLESS execute capability 
for the file has been restricted to the creator only. In this case, you are prompted for any lockword 
before the display is produced. 
(c) Program File Display 


Information provided in the Program File Display is limited, depending on your attributes, in the follow- 
ing way: . 


The actual name of a program file is included in the display ONLY if one of the following conditions is 
met: 


The file resides in PUB.SYS 


You are allowed to generate a Program File Users Display (see above) for the program file. Note 
that the lockword prompt is not made. 


773 


Process Context (#P) 


For example, assume that the following files are the program files currently in use on a system: 


CAT.PUB.SYS 
EDITOR. PUB.SYS 
TEST.CARRI.USERS 
REPORT. JOAN.USERS 
GAME . PUB.GAMES 


If you have SM or OP capability, the names of all five program files are provided on the display. 


The Account Manager for the account USERS are provided the names of four program files: CAT, 
EDITOR, TEST, and REPORT. 


If you are the creator of the file REPORT. JOAN.USERS, you are provided the names of three program 
files: CAT, EDITOR, and REPORT. 


If you are logged onto the group PUB.GAMES, you are provided the names of three program files: CAT, 
EDITOR, and GAME. 


If you are logged onto the group MATT.SUPPORT, you are provided with the program files CAT and 
EDITOR. (Files in PUB.SYS are available to anyone on the system after logon.) 


The above restrictions refer to the program name only. All other information about a program file, such 


as number of users and size of the working set, are provided to any user of OPT/3000. If you do not have 
the needed capabilities to obtain the program name on your display, USER PROGRAM FILE replaces it. 
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Process Context (#P) 
USER SUMMARY REPORT (GQ) 


The user summary display is the highest level display concerned with individual process information. This 
display shows the CPU usage, the queue that the process is executing in, the current priority, the pin num- 
ber, the job/session number, the user and account names and the program name. To access this display 
from any other display in the process context, enter "G". 


USER SUMMARY REPORT Filters: A (all processes) C (CPU users only) 9:36 AM 


| B (paging) — D (user account) 

PIN J/S# USER. ACCOUNT PROGRAM NAME (command) CPU % Q PRI 
28 $18 MEL.ES USER PROGRAM FILE 424 0 C 152 
49 JT MANAGER.SYS USER PROGRAM FILE 21316 O OD 202 
50 J6- HALEY.SYS USER PROGRAM FILE 565 0 L 100 
54 JQ MANAGER.SYS USER PROGRAM FILE 40016 OO. D 202 
60 J11 MGR.RSPOOL USER PROGRAM FILE © 56849 0O C 152 
61 Ji2 MGR.RSPOOL USER PROGRAM FILE 54975 0 Cc 152 
62 Ji1 MGR.RSPOOL USER PROGRAM FILE 90416 O Cc 152 
63 Ji2 MGR.RSPOOL USER PROGRAM FILE 110514 1 C 152 
124 $36 SCOTT .SM USER PROGRAM FILE 8780 0 C 152 
171 $44 TOM. CSC USER PROGRAM FILE . 1794 0 Cc 152 
192 $24 MGR. PERF DEV TDP. PUB.SYS 12796 O Cc 152 

0 ¢C 156 


202D $41 RAT. PERF DEV OPT78.LACH. PERFDEV 1619 1 


Figure 9-3. Users Summary Report 


Display Description 


Each line of this display represents one active process in the system. To the far left of the line is the 
process’s PIN number followed by the job/session number. A capital D is appended to the end of the PIN 
number if the process is executing on the dispatch queue. The user and account name is listed next, fol- 
lowed by the fully qualified program name if it is a user process. For an active C.I. process (i.e.,a C.L 
process without an active user son process), a C.I. followed by it’s last executed command in parenthesis 
replaces the program name. percentage of time the CPU was used by the process during the last sample 
interval is displayed next, followed by the queue that the process is executing on and the current priority. 
CPU time can be displayed in milliseconds (S) or minutes (M). Processes shown for the first time appear in 
inverse video. : 


The initial display contains only user processes, but an A command displays all active processes,including 
system processes and CI processes waiting on son processes). The A command is a toggle, and a second A 
command displays only user processes. Similarly, the C command displays only CPU active processes. This 
command is also a toggle. A paging command, B, is also a toggle and is initially turned on. When the 
command is on, you are prompted at the end of each screen to continue or not. At this point, you can stop 
the printing of the rest of the display. This saves time if many processes are executing. When the paging 
toggle is turned off, all processes are displayed without any pauses. 


Process Context (#P) 


There are four toggles available on this display: 


TOGGLE : ON OFF INITIALLY 
A Display all active processes. Display only user processes. OF F 
B Paging on. Paging off. ON 
C Display only CPU active processes. Display all processes. OFF 
D Display only processes in the Display all processes. OFF 


specified user account. 


The toggle commands in effect at any time appear highlighted in inverse video at the top of the display. 
For more details on these commands, see the Additional Commands at the end of this section. 


These toggles can be used in any combination. When the ’D’ and ’A’ toggles are both on, all system 
processes are displayed, as well as those CI and user processes in the specified user account. If a non- 
existent user account is specified for the D toggle, the message "NO VALID USER ACCOUNT” will be dis- 
played, and the toggle will be turned off. This will also happen is both the C and D toggles are on, and 
there are no CPU active processes in the specified user account. All commands are toggled by entering 
the appropriate letter, but to turn off the D toggle, a carriage return must be entered at the user account 
name prompt. 


Interpretation Guidelines 


Any process that has a large percentage of CPU time is not necessarily using other processes’ share of CPU 
time, especially if its priority is low. Use the process display to obtain more information. 


Legend 


The total CPU time is in milliseconds unless noted by "S" (seconds) or "M" (minutes) on the display. 
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PROGRAM FILE DISPLAY (F) 


The Program File Display concerns itself with program file usage, identifying all program files which are 
either allocated, auto-allocated, or are currently in use. Information about the combined working sets of 
each program file is provided, as well as the working sets of system processes and Command Interpreter 
processes. This display can be accessed from other displays within the Process Context by entering i es 





FILE. DISPLAY 10:34 AM 

~~ CODE SEG INFO COMBINED WORKING SET INFORMATION 
NAME OF PROGRAM FILE COUNT:SIZE #PS CST:PROG: DST:STACK:TOT. SIZE 

1 OPT76 ~ .LACH -PERFDEV 37:131428 1 0: S: 1: 1 27944 
2 IDATS5 .PUB .SYS 1: 13904 1 1: 0: 4: 1 25716 
3 MANSION .LEONG  .LEONG 1: 312 1 i a a ee a 18780 
4 FORMSPEC. PUB .SYS 22: 86696 1 O: 6: O: 1 40992 
5S HPDRAW .PUB .SYS 41:276724 1 O: 0: 5: 1 50888 
6 HPTREND .HPTREND .SYS 4: 1512 1 Gos tes ee 4 10920 
7 PBXUSEP .PBX .SYS 2: 3316 1 0: O: 3: 1 10220 
8*DICTDBM .PUB .SYS 16: 95916 0 O: 0: 0: O 0 
9 RSPOOL .PUB .RSPOOL 2: 6464 2 0: 0: 6: 2 12664 
10 DSMON .PUB — .SYS 3: 3500 3 4: ode: 3 41720 
11#QEDIT  .PUB -ROBELLE 13: 71596 1 0: 4: O: 1 27556 
12"INFORM .PUB .SYS -  41:116276 0 0: 0: 0: O 0 
13*#TRANCOMP. PUB .SYS 11: 79104 0 0: 0: 0: O 0 
14*TRANSACT. PUB .SYS 11:116280 3 1: 0:13: 3 75668 
15*SPOOK2 .PUB © .SYS 3: 12308 2 0: O: 5: 2 31364 


ENTER ii TO GENERATE A PROGRAM FILE USERS DISPLAY FOR ANY OF THE ABOVE PROGRAMS 


Figure 9-4. Program File Display 


Display Description 


Each line of this display represents one program file or set of system processes, and there are four primary 
sections of information provided in each line. 


e At the left of each line is an identifier (SP, CI, 1..N) that is used for subsequent references to in- 
dividual program files when you access the Users Display. "SP" refers to the set of system processes, 
"CI" to the Command Interpreter, and the integers 1..N to individual program files. Note that the 
integer identifier may change when the display is updated. 

e The second segment on the display is the code segment information, labeled "CODE SEG INFO". It 
contains the number of code segments in the program file, and the total size of the program file in 
words. This information is not listed for the system processes or Command Interpreter. 


e The third section is headed "#PS" and indicates the number of processes sharing the program file on 
each line. Note that the count may be zero for allocated program files. 


e The fourth section of information concerns the combined working sets of all processus represented by 
the line. It shows: 


The number of SL code segments 
The number of program file code segments 


The number of data segments (non-stack) 
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Process Context (#P) 


The number of stack segments 


The total size of all segments in the combined working set 


Note that a specific segment may be in more than one working set of a combined working set, but it is 
counted only once. 


By default, allocated and autoallocated program files with no current users are not included in this dis- 
play. To include such files, use the In-Use-Only command. See Additional Commands at the end of this 
section. 


Interpretation Guidelines 


Allocating a program file reduces the overhead. Program files that are frequently run (required for 
the first execution of the program) should be reviewed for possible allocation. 


Under normal circumstances, the working set of a single process should consist of no more then four 
segments. The current code segment for the process, the process stack, the DST to which DB is set, 
and a DST with a disc I/O pending against the segment. This implies that the total size of the com- 
bined working sets for a program is not a true indicator of memory requirements. 


Legend 


An asterisk next to the identifier indicates that the program file has been allocated via the : ALLOCATE 
command. 


An @ next to the identifier indicates that the program file has been auto-allocated via the 
: AUTOALLOCATE command. 


The count for the Command Interpreter under the #PS section is the number of CI processes not 
waiting on a SON process. 
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Process Context (#P) 


The Program File Users Display provides information about each process sharing a particular program file, 
or each process in a set of system processes. 


PROGRAM FILE USERS DISPLAY for SYSTEM PROCESSES 


# USER NAME 


eee eee me mee ee ee em we 


6 MEMLOGP 

~ PVPROC 

8 UCOP 

9 PFAIL 

10 DEVREC 

11 LOAD 

12 (unknown) 
13 SPOOLER-6 
15 SPOOLER-80 
16 SPOOLER-86 
17 SPOOLER-91 
59 (unknown) 
61 (unknown) 
62 (unknown) 
121 SPOOLER-79 


ENTER P TO GENERATE A PROCESS 


STACK STACK 
J/S #Q SIZE UTIL 


6808 67.0% 
1404 25.9% 
2036* 4.3% 
2748 1.2% 
7532*57.2% 
4972#34.5% 
2600* 1.5% 
~ 7072 71.4% 
3636*38.7% 
3636#*38 .7% 
4148*33 .0% 
6984#12.1% 
6984*12.1% 
6984*10.3% 
3636*38 . 7% 


Co ERE ee ese eee ee 


MAX 


768 164539 
2304 0 
43826 
7603 1726 S 
291703 

584 
($52 
2290 

1880 40417 
6424 444025 
6424 213614 
6424 4550 S$ 
1880 2706 


oooooaooaooaoooncTcooo— 


oo0ooooooqooo0oo0oo00 © 


10:22 AM 


STATUS FLAGS 


awww ew we wwe www wm we eR OO OO eH OOO Ew Tw ON Oe 


JUNK 
JUNK, TIME 
JUNK ,MEM 
1/0, JUNK 
MSG 

JUNK 

FA 
SON,FA 
SON ,FA 
SON ,FA 
1/0,MSG 
1/0,MSG 
1/0 

SON ,FA 


DISPLAY FOR ANY OF THE ABOVE PROCESSES 


Figure 9-5. Program File Users Display (system processes) 


This display can only be accessed by entering "U" after the generation of the Program File Display. 
Entering the command at any other time produces the message: . . 





and the current display is updated. 


After entering a "U", you will be prompted for the indices of the program files for which the Program File 
Users Display is to be generated: 


ENTER INDICES OF PROGRAMS ON WHICH INFORMATION IS DESIRED (’@’ OR <CR> FOR ALL) 


> 


To access system processes, enter SP. To access command interpreter processes, enter CI in reply to this 


prompt. 


Process Context (#P) 


PROGRAM FILE USERS DISPLAY for TDP. PUB.SYS 11:39 AM 
PIN STACK STACK MAX CPU # # 
# = USER NAME J/S #Q SIZE UTIL 2Z-DL USED FO XD STATUS FLAGS 
199 JOAN .SM S 790 C 4000*68.4% 3258 2243 6 0 BIO 
224 MARCIA .ES S 773 C 4504*58.8% 3258 5146 6 0 BIO 
35 JERRY .PERFDEV S 736 C 4544#66.8% 3258 782 7 0 BIO 
198 ED .SM S 646 C 5112%50.9% 3258 4430 6 1 BIO 
108 ARTHUR .SS S 727 C 5104%58.2% 3258 2167 7 1 BIO 
125 SS .SS S 751 C 5112%50.6% 3258 21895 6 0 BIO 
150 TOM .HENNEMAN S 753 C 4944 50.7% 4938 28368 6 O SON 
237 ED » WRIGHT S 749 C 4944*52.6% 4930 13623 6 1 BIO 
94 HANK —.SM S 717 C 5104 58.2% 3258 1763 7 O BIO 


ENTER P TO GENERATE A PROCESS DISPLAY FOR ANY OF THE ABOVE PROCESSES 


Figure 9-6. Program File Users Display (User Program) 


These indices correspond to the identifiers listed in the Program File Display. You must separate multiple 
identifiers with commas. Entering a instead of indices will generate a display for each program 
file in succession. If you enter an index that doesn’t reference an entry in the Program File Display, 
OPT/3000 prints the following message: 


“Z’ IS INVALID 
and repeats the prompt. 
After the desired list of indices has been entered, OPT/3000 generates the Program File Users Display for 
the first identifier specified, and continues to update that display at the usual update interval until you 
enter a valid command that changes the current display. Entering the N command will cause OPT/3000 
to generate the Users Display for the next specified identifier or, if the end of the list has been reached, 


generate the Program File Display. 


If all processes sharing the program file terminate while the display is still current, the message: 





is generated. If a process terminates execution while OPT/3000 is in the process of gathering informa- 
tion to generate or update the display, the message: 





appears on the line for that process. When the display is updated, new processes sharing the program file 
are added to the display and processes no longer sharing the program file are removed from the display. 


Display Description 


Each line of this display represents one process using a particular program file. The name of the program 
file appears at the top of the screen. Figure 9-5 shows each of the system processes currently operating 
on a system. These particular processes were generated by entering the identifier "SP" in response to the 
prompt within Program File Display. 


Process Context (#P) 


There are nine primary sections of information on each line. From left to right these are: 


The PIN number indicated in decimal and the user and account name under which the process was 
created. If the display is for a system process, the name of the system process will be shown here. 


The session or job number of the process and the queue in which the process is executing (L, C, D, 
E). 


The current stack size in words. 

Stack utilization. 

Maximum size of the Z-DL or user portion of the stack. 

CPU usage. 

Current number of open files (#F0O) for the process 

Number of extra data segments (#XD) explicitly obtained by the process. 


Current status (STATUS FLAGS) of the process. | 


Explanations for these items are given in the "LEGEND" section. 


You can obtain additional information about the combined working sets of all processes represented in 
this display by using the List Working Set Segments (W) command. If (W) is performed information about 
each segment in the combined working sets is displayed in three columns as follows: 


e DST,CST, or CSTX index (displayed in octal) 


e Size of the segment in words 


e Working set count 


For more information about the (W) command, see the discussion under the "List Working Set Segments 
Command" in this section. 


‘Process Context (#P) 


Interpretation Guidelines 


Batch jobs executing in the "C" queue may be causing performance problems. 
Sessions executing in the "D" queue are probably getting poor response times. 


Stack utilization may fluctuate dramatically for processes with small stacks depending on the value 
of the S register when the sample is taken. Values which are consistently low, however, may indicate 
that a reduction in the stack size (either programmatically or in the initial size) could improve 
performance. | 


The MAX Z-DL figure can be used to determine if a MAXDATA value is too large. An excessive MAXDATA 
value wastes virtual memory disc space. 


Processes that frequently wait on RIN’s or impedes may be having performance problems. 


Under normal circumstances, the working set of a single process should consist of no more than four 
segments: the current code segment for the process, the process stack, the DST to which DB is set, and 
a DST with a disc I/O pending against the segment. This implies that the total size of the combined 
working sets for a program file is not a true indication of the memory requirements. 


Legend 


L = linearly scheduled process on the AS or BS subqueues or Master queue (very high priority). 
C = circularly scheduled process on the CS subqueue (interactive sessions). 

D = circularly scheduled process on the DS subqueue (batch jobs). 

E = circularly scheduled process on the ES subqueue (processes scheduled in a very low priority). 


Stack size is the total size of the stack segment, including the PCBX area appended to the stack by 
MPE. An asterisk (*) after the stack size indicates that the stack is present in memory. 


Stack utilization is estimated by dividing the current value of the S register by the current value of 
the Z register. 


The maximum size of the user portion (Z-DL) of the stack may be smaller than the current stack size 
since it does not include the PCBX area. 


CPU usage is the number of milliseconds of CPU time charged to the process. If the number of mil- 
liseconds exceeds 999999 millisecs, then it is displayed in seconds and an "S" is appended in the field. 


Status Flags 


Process Context (#P) 


A set of WAIT FIELDS in the PCB are used to describe the reason or reasons’a process is not active. A 
process is suspended because it cannot get access to a resource or because it is waiting for another event to 
be completed. The resource could be disc I/O, RIN’s, MEMORY, or the process could be waiting for its 
“SON or FATHER to "wake it up". The interpretation of the bits in the WAIT FIELDS is: 


MRNG (Mourning Wait) 
GRIN (Global RIN) 
LRIN (Local RIN) 
MAIL (Mail Wait) 


BIO (Blocked I/O) 


I/O (Unblocked I/0) 


UCOP (UCOP Wait) 


JUNK (Junk Wait) 

_ TIME (Timer Wait) 
MSG (Message Wait) 
SON (Son Wait) 


FA (Father Wait) 


IMP (Impeded) 


SIR (SIR Wait) 
TOUT (Timeout Wait) 


MEM (Memory Wait) 


The process is waiting for its SON to complete. 

The process is waiting for a global RIN. 

The process is waiting for a local RIN. 

The process is waiting for the completion of a MAIL transaction. 

The process has issued a blocked eeqiext (oe I/O and for 1/O comple- 
tion before continuing. Most applications are blocked for I/O on each 


read or write. 


This process has issued a request for NO-WAIT I/O, has subsequently 
finished its interim processing, and called the IOWAIT intrinsic. 


Either the process is waiting for service by UCOP or the process is 
waiting for a REPLY asa result of an entry in the RIT (reply informa- 
tion table). 

Miscellaneous waits used by system processes. 

The process is waiting for a timer requested interrupt. 

The process is waiting for the completion of I/O to message files. 


The process is waiting to be activated by its SON. 


The process is waiting to be activated by its FATHER. Both the 
FATHER WAIT and SON WAIT bits can be set at the same time. 


The process in impeded. Impedes are generated for may reasons. 
Examples are waiting for an IMAGE data base lock, waiting to access 
an IMAGE data base control block and waiting for avaiiable system 
table entries. 

The process is waiting for a SIR. 


The process is waiting for a "time-out" to occur. 


The process is waiting for one or more segments to be swapped into 
memory. 


Note that more than one of these conditions can occur at any one time. 


ee Context (#P) 
PROCESS DISPLAY (P) 


The Process Display is the most detailed display of the Process Context and provides information about a 
single process sharing a program file, including a system program. 


PIN: 5 SYSTEM PROCESS LOG USER: ( ) 10:26 AM 










STACK INFORMATION CPU TIME: 455606 MSEC|STATUS FLAGS: 

DST: 101* SYSOV: 572 22.7% 
SIZE: 2524 DL-DB: 0 .0% 
MAXDATA: 2524 DB-QI: 177 7.0% 
MAX Z-DL: 1792 QI-Q: 10 4% 
Q-S: 9 4% 

1756 69.6% 







PRIORITY: 50 
CAPABILITIES: SM AM] BIO 
AL GL DI OP CV UV LG|TIME MSG SON FA 
SP PS NA NM CS ND SF . 
BA IA PM MR DS PH 





XDS USAGE SON 
DST# SIZE PROCESS OPEN FILES 


ee eee me ee ewe ee ew ewe ew ew ee 


LOG1540 
Figure 9-7. Process Display (system processes) 


This display can only be accessed by entering "P' while OPT/3000 is accepting commands, and only after 
you have generated the Program File Users Display or the User Summary Report Display or when you 
first enter the Process Context. If you attempt to enter the display at another time, the error message: 





is generated and the current display is updated. 
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PIN: 194 OPT78.LACH.PERFDEV USER: RAT.PERFDEV (S 41) 9:33 AM 







“STACK INFORMATION CFU LIME? 1287 MSEC|STATUS FLAGS: 

DSI 661* SYSOV: 557 3.8% 
SIZE: 14588 DL-DB: 6616 45.4%|PRIORITY: 152 MRNG GRIN LRIN MAIL 
MAXDATA: 31223 DB-QI: 4940 33.9%|CAPABILITIES: AM AL} BIO I/O UCOP JUNK 
MAX Z-DL: 29859 QI-Q: 44 .3%| GL ND SF BA IA PM MR/ TIME MSG SON FA 
Q-S: 263 1.8%! DS PH | IMP SIR TOUT MEM 

S$-Z: 2168 14.9% 


XDS USAGE SON 
DST# SIZE PROCESS OPEN FILES 


$STDIN $STDLIST $STDINX 


Figure 9-8. Process Display (user program) 


Once this display is accessed, you are prompted for a list of process identification numbers (PIN’s) for 
which you want the Process Display generated. 


ENTER PINS OF PROCESSES FOR WHICH INFORMATION IS DESIRED ("@" or <CR> FOR ALL) 


The PIN’s you specify must be among those appearing in the current display and must be separated from 
one another by commas. If you enter an invalid number, (i.e., a number that does not reference a PIN in 
the current display), the message: 


###WRONG PIN NO. ENTER CORRECT PIN AGAIN OR <CR> TO USER SUMMARY REPORT### 


is displayed and the prompt repeated. Entering instead of PIN numbers causes a Process Display 
to be generated for each process in the current display. If there 1s only one process in the display, 
OPT/3000 prompts you, but automatically generates the Process Display for that process. 


Once you have entered the PIN numbers, OPT/3000 generates the Process Display for the first PIN 
specified, and continues to update that display at the set update interval until you enter the Next com- 
mand (N) or one of the other Process Context commands. Entering the NEXT (N) command causes 
OPT/3000 to generate the Process Display for the next PIN on your list. When the end of the list is 
reached, the previous display is generated. 


If the process being displayed terminates execution while the display is being updated, OPT/3000 displays 
the message 


###PROCESS NO LONGER EXECUTING###* 


and automatically executes a NEXT command at the time of the next display update. 


NOTE 


Access to this display is subject to certain security restrictions. See the 
"SECURITY RESTRICTION" section at the beginning of this context for 
further information. 


Process Context (#P) 


Display Description 


There are 7 main areas of information shown in this display in addition to the heading. Working set in- 
formation may also be included if you have set the List Working Set Segments flag. 


The heading includes the PIN number (decimal), the fully-qualified program file name, the user and ac- 
count of the process creator, and the job/session number. If the process is a system process, the name of 
the system process replaces the program file name. The user name, account name, and job/session number 
will be omitted. 
The first area of information concerns the stack and includes: 

DST number of the stack (octal) 

Size of the stack in words 

The MAXDATA specified for the stack (words) 

The maximum size of the Z-DL area of the stack in words 
Each of the following are shown as their size in words, and their percentage of the entire stack: 

System Overhead (SYSOV) - This includes PCBX plus stack overflow 

DL-DB area 

DB-initial Q area 

Initial Q-current Q area 

Q-S area 

S-Z area 


Note that an asterisk (*) appears after the stack DST number if the stack is present in memory. 


The area immediately to the right of the stack information area contains the following miscellaneous in- 
formation about the process: 


CPU time - CPU time used by the process in either milliseconds or seconds. 
Priority - Process priority (NOTE: Processes are executed in ascending order of priority). 
Capability List - The list of the bees capabilities. The capabilities are listed in three groups: 
Group l. SM,AM,OP,AL,GL 
Group 2. DI,UV,LG,ND,SF,CS,CV,SP,PS,NA,NM 
Group 3. . PM,PH,DS,MR,IA,BA 
The upper right area of your screen indicates the current status of the process. Each of the 16 Status 


Flags is shown, and those currently set are highlighted with inverse video. The Status Flags are defined in 
the Legend section below. 


Process Context (#P) 
The lower left area lists all information about all extra data segments that have been explicitly obtained 
by the process. For each extra data segment, the following information is reported: 
DST number of the segment (octal) 
Size of the data segment in words 
In addition, an asterisk (*) appears following the DST number if the segment is darrently in main memory. 


The area to the right of the extra data segment area lists all son processes created by the process, indicated 
by the son process’ PIN number (decimal). 


The final area of information, located to the middle of your screen, lists all files currently opened by the 
process. Up to six files may be listed on each line. A fully-qualified name is not listed. A question 
mark (?) in the list of file names indicates a file opened with no file name specified. 


Interpretation Guidelines 


e If the S-Z portion of the stack is consistently large re than fifty eens) the stack is probably 
larger than necessary. 


e Processes with large extra data segments may be causing performance problems. 


e Under normal circumstances, the working set of a single process should consist of at most four seg- 
ments: the current code segment for the process, the process stack, the DST to which DB is set, and a 
DST with a disc I/O pending against the segment. This implies that the total size of the working set 
for a program file is NOT a true indication of the memory requirements. 


Legend 

There are 16 Status Flags, more than one of which may apply at once. 

A set of WAIT FIELDS in the PCB explain why a process is not active. A process is suspended if it cannot 
get access to a resource, or if it is waiting for another event to be completed. The resource could be disc 


I/O, RIN’s, MEMORY, or the process could be waiting for its SON or FATHER to "wake it up". The in- 
terpretation of the bits in the WAIT FIELDS follows: 


MRNG (Mourning Wait) - The process is waiting for its SON to complete. 

GRIN (Global RIN) - The process is waiting for a global RIN. 

LRIN (Local RIN) - The process is waiting for a local RIN. 

MAIL (Mail Wait) a The process is waiting for the completion of a MAIL transaction. 

BIO (Blocked I/0) - The process has issued a blocked request for I/O and waits until the 


I/O is completed, before continuing. Most applications are blocked 
for I/O by each read or write. 


1/O (Unblocked I/O) - This process has issued a request for "no-wait" I/O, has subsequently 
finished its interim processing, and called the IOWAIT intrinsic. 
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UCOP (UCOP Wait) 


JUNK (Junk Wait) 
TIME (Timer Wait) 
MSG (Message Wait) 
SON (Son Wait) 


FA (Father Wait) 


IMP (Impeded) 


SIR (SIR Wait) 
TOUT (Timeout Wait) 


MEM (Memory Wait) 


Either the process is waiting for service by UCOP or the process is 
waiting for a REPLY as a result of an entry in the RIT (reply informa- 
tion table). 

Miscelianeous waits used by system processes. 

The process is waiting for a timer requested interrupt. 

The process is waiting for the completion of I/O to message files. 


The process is waiting to be activated by its SON. 


The process is waiting to be activated by its FATHER. Both the 
FATHER WAIT and SON WAIT bits can be set at the same time. 


‘The process in impeded. Impedes are generated for may reasons. 


Examples are waiting for an IMAGE data base lock, waiting to access 
an IMAGE data base control block and waiting for available system 
table entries. 

The process is waiting for a SIR. 


The process is waiting for a "time-out" to occur. 


The process is waiting for one or more segments to be swapped into 
memory. 


NOTE 


Not all of these bits are shown on all displays. They are included in the 
documentation for completeness. 


Process.Context (#P) 
PROCESS STATE REPORT DISPLAY (R) 


The Process State Report display can be accessed by entering "R' from within the Process Context when- 
ever OPT/3000 is accepting commands. 


PROCESS STATE REPORT | 7 10:30 AM 


SESSIONS: 41 SYSTEM PROCESSES: 20 DISPATCH QUEUE: 1 
JOBS: 4 CI PROCESSES: 26 NO QUEUE: 84 
USER PROCESSES: 19 


IN BREAK: 0 CREATED PROCESSES: 2 


ec TEE gy EnEnE SOIR eam nerrnen stems ame eneemnenmeeemnnnmnnnstn:eneseemnernmmnanmanetsataamniaaaatl 


DISTRIBUTION OF PROCESS STATES 


DISPATCH QUEUE NO QUEUE 
SHORT WAIT 
LONG WAIT 1 68 
TERM READ WAIT | 1 38 
BLOCKED 1/0 WAIT 40 
1/O WAIT 5 
MEMORY WAIT | 1 
SON WAIT 22 
FATHER WAIT 5 
RIN WAIT _ 
SIR WAIT 
IMPEDED 1 


SCHED ATTN REQ 
Figure 9-9. Process State Report 


This display provides detailed summary information about all processes known to the system and describes 
the state of the system at the time the display is generated. Included in this information is the type of 
process, the number of sessions and jobs, and the distribution of process states between queues. No 
averages Over time are reported. 


Display Description 
A horizontal line divides the screen into two parts. The top half displays summary information about each 
type of process (CI, System, User, and Created), and statistics about how many processes are in the Dispatch 


Queue. 


‘The bottom half of the display distinguishes between process states in the Dispatch Queue and those not in 
a queue. The number of processes in each state is reported for each of the queue categories. 
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Interpretation Guidelines 


e If the number of processes on the dispatch list is large (greater than five), CPU contention may be a 


problem. 


e If the number of processes on a short wait is large (greater than five on any single configured con- 
troller - See #I context for further analysis), disc contention may be a problem. 


Legend 

PROCESSES 
CI Processes 
SYSTEM Processes 
USER processes 


CREATED Processes 


- CI processes that are not waiting on a SON process. 


- Processes such as the SPOOLER or MEMORY LOGGING. 


= Processes that are sons of CI processes. 


~ Processes that are sons of user processes of other 
processes. 


A set of WAIT FIELDS in the PCB explain why a process is not active. A process is suspended if it cannot 
get access to a resource or because it is waiting for another event to be completed. The resource could be 
disc I/O, RIN’s, or MEMORY, or the process could be waiting for its SON or FATHER to "wake it up". 
The interpretation of the bits in the WAIT FIELDS follows: 


If a process is waiting, it is usually in a SHORT WAIT or a LONG WAIT. There are some special cases for 


which neither bit is set. 
MRNG (Mourning Wait) 
GRIN (Global RIN) 
LRIN (Local RIN) 
MAIL (Mail Wait) 


BIO (Blocked I/0) 


I/O (Unblocked 1/0) 


UCOP (UCOP Wait) 


JUNK (Junk Wait) 


TIME (Timer Wait) 


The process is waiting for its SON to complete. 

The process is waiting for a global RIN. 

The process is waiting for a local RIN. 

The process is waiting for the completion of a MAIL transaction. 

The process has issued a blocked request for I/O and waits until the 
I/O is completed, before continuing. Most applications are blocked 


for I/O by each read or write. 


This process has issued a request for "no-wait" I/O, has subsequently 
finished its interim processing, and called the IOWAIT intrinsic. 


Either the process is waiting for service by UCOP or the process is 
waiting for a REPLY asa result of an entry in the RIN (reply informa- 
tion table). 


Miscellaneous waits used by system processes. 


The process is waiting for a timer requested interrupt. 
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MSG (Message Wait) 
SON (Son Wait) 


FA (FATHER Wait) 


IMP (Impeded) 


SIR (SIR Wait) 
TOUT (Timeout Wait) 


MEM (Memory Wait) 
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The process is waiting for the completion of I/O to message files. 
The process is waiting to be activated by its SON. 


The process is waiting to be activated by its FATHER. Both the 
FATHER WAIT and SON WAIT bits can be set at the same time. 


The process in impeded. Itmpedes are generated for may reasons. 
Examples are waiting for an IMAGE data base lock, waiting to access 
an IMAGE data base control block and waiting for available system 
table entries. 

The process is waiting for a SIR. 


The process is waiting for a "time-out" to occur. 


The process is waiting for one or more segments to be swapped into 
memory. 


NOTE 


Not all of these bits are shown on all displays. They are included in the 
documentation for completeness. 


A given process may be in one or more of the above states. Therefore, the total for a column will prob- 
ably be greater than the number of processes in the category represented by that column. 
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Process Context (#P) 
ADDITIONAL COMMANDS 


In addition to the five displays, these commands are provided in this context: 
| (I) "In Use Only" Command 
(N) Next Command 
(W) List Working Set Segments Command 
(S) List SIR Information 
(A) All Process Command 
(C) Display Processes for Active CPU Users Only 
(B) Turn Paging On or Off 
(M) List Stack Markers 


(D) List User Account Only 


In Use Only Command (I) 


This command allows you to include allocated and autoallocated program files with no current users in 
the Program File Display. 


10:19 AM 





CODE SEG INFO COMBINED WORKING SET INFORMATION 

NAME OF PROGRAM FILE COUNT:SIZE #PS CST:PROG: DST:STACK: TOT. SIZE 

SP SYSTEM PROCESSES 20 4: -6 ¢ 22:4 20 : '50528 
CI COMMAND INTERPRETER 24 4: 0: 57: 23 : 198412 
1 OPT76 . LACH -PERFDEV 37:131428 1 Oo Bee Oe eS 25776 

2 MANSION .LEONG . LEONG rs 312 1 2.8. is ee 4 18780 

3 FORMSPEC. PUB SYS 22: 86696 1 O%g:: Hose Ole 4 40992 

4 HPDRAW .PUB SYS 41:276724 { Oe OR ed 50888 

5 HPTREND .HPTREND .SYS ts TSt2 1 Oise oh ee 4 10920 

6 PBXUSEP .PBX SYS 2: .3316 1 Org Ag Rg | 10468 

7 RSPOOL .PUB RS POOL 2: 6464 2 Oise. 1 S.4 GB rs, Ye IS 16228 

8 DSMON . PUB SYS 3%” 3500 3 Heres 3 Sy. at ee Oe 42200 

9*QEDIT . PUB -ROBELLE 13: 71596 1 Oe 43-0 OP os 27556 

10*TRANSACT. PUB SYS 11:116280 3 Ae ge. ADE > Ss ir 75668 
11*SPOOK2 .PUB SYS 3: 12308 2 Os 30 es 8 Se 16648 
12*TDP . PUB SYS _ af: 84436 6 13) O14 19° 6 90728 


Figure 9-10. Program File Display (In use only toggle on) 
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The command acts as a toggle that controls the setting of a flag. If the flag is "OFF", allocated and 
autoallocated program files with no users are included in the File Display. See Figure 9-10. To turn the 
flag "ON", enter the command again. This command is recognized only when the current display is the 
Program File Display, and is interpreted asa if entered at any other time. The flag is "ON" upon 
entering the Process Context. 


Next Command (N) 


This command allows you to terminate the updating of a a File Users Display or a Process Display. 
Entering "N" causes OPT/3000 to either: 


e Generate the current display for the next program file or process specified (if multiple program files 
or processes were specified) or, 


e Return to the screen display before entering the current display or if the last program file or process 
has been displayed. 


The NEXT command is only applicable to the Program File Users Display and the Process Display. If you 
attempt to enter it from any other display, it is recognized as a (RETURN). 


List Working Set Segments Command (W) 


This command allows control of the List Working Set Segments flag, which determines whether or not 
working set information is displayed in the Program File Users Display and the Process Display. The flag 
flips to the opposite state ("ON" or "OFF") each time the W command is entered. The flag is in an "OFF" 
position upon entry to the Process Context. 


The working set information is interpreted as follows: 


CST - Code segments from an SL. 
CSTX ~ Code segments from a program file. 
DST ~- Data segments (An "S" to the right of an index entry) 


indicates a stack segment. An asterisk (*) to the right of 
an index entry indicates a stack present in memory. Segment 
size is shown in words. 
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XDS USAGE SON | 
PIN: 101 OPT76.LACH. PERFDEV USER: RAT. PERFDEV (S 745) 11:34 AM 










STACK INFORMATION 

DST: 331% SYSOV: 557 3.8% 
SIZE: 14800 DL-DB: 6488 43.8% 
MAXDATA: 31223 DB-QI: 4940 33.4% 
MAX Z-DL: 14243 QI-Q: 44 3% 
Q-S: 263 1.8% 

$-Z: 2508 


CPU TIME: 1280 MSEC|STATUS FLAGS: 













PRIORITY: 152 MRNG GRIN LRIN MAIL 
CAPABILITIES: SM AM} BIO I/O UCOP JUNK 
AL GL DI OP CV UV LGITIME MSG SON FA 
SP PS NA NM CS ND SF} IMP SIR TOUT MEM 
BA IA PM MR DS PH 








DST# SIZE PROCESS OPEN FILES 


$STDIN $STDLIST $STDINX 


CST # SIZE CSTX # SIZE DST # SIZE 
27-023 3172 456% 104 
27-024* 2160 331*S 14800 
27-025* 2604 
27-026* 2748 
27-027% 3360 


Figure 9-11. Process Display (Working set toggle on) 


The Working Set Segments command is recognized only when your current display is the Program File 
Users Display or the Process Display. If you enter it at any other time, it is interpreted as a (RETURN). 


List SIR Information (S) Command 


This command is available anywhere within the Process Context. It lists the SIR number and name, the 
current holding PIN number, and a list of all PIN’s working on the SIR for all currently-locked SIR’s. 


List Stack Markers (M) Command 


This is a toggle command available in the Process Display. It lists the stack marker trace of the processes 
displayed. The toggle is OFF when a new process is displayed. 


List All Processes (A) Command 


This is a toggle command available in the User Summary Report Display. When the toggle is ON, all ac- 
tive processes (including system procesess and CI processes waiting on SON processes to be displayed) are 
displayed. When the toggle is OFF (the default), only user processes are displayed. 
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Paging (ON/OFF) Command 


This is a toggle command available in the User Summary Report display. When ON (the default), you are 
prompted at the end of each screen: 


CONTINUE? (YES/NO) 


If you enter YES, the next process is displayed. Enter NO and no further processes are displayed. 


List CPU Active Processes Only (C) Command 
This is a toggle command available in the User Summary Report display. When ON, only processes that 


used any CPU time during the interval displayed are shown. When OFF (the default), processes that did 
~ not use CPU time during the interval are also shown. 


List By User Account (D) Command 


‘his is a toggle command available in the User Summary Report. When ON, only processes in the user ac— 
count you specify are shown. When OFF (the default), all processes are displayed. 
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SECTION 


SYSTEM TABLES CONTEXT (#T) 
- | | 10 





The System Tables Context provides information about the usage of MPE tables, data structures, and 


queues. 
OPT/3000 
CONTEXTS 


GLOBAL CPU-~MEMORY MEMORY vo PROCESS syst EM 
CONTEXT MANAGER CONTEX CONTEXT CONTEXT CONTEXT FABLES CONTEX H 


‘at 


OBAL CPU-MEMORY . | MEMORY REPORT USER ACTIVITY] USER | TABLE 
§ MANAGEMENT DISPLAY REPORT SUMMARY UTILIZATION: 
RT sas : ary REPORT. | 
MEMORY MEMORY DISC ACTIVITY | PROGRAM FILE | DETAILED TABLE 
MANAGEMENT CONTENTS REPORT OISPLAY ORMATION... 
> saad DISPLAY Sarak PLAY: 
CPU USAGE BANK PROGRAM FILE 
DISPLAY CONTENTS TAPE SE ACTIVITY USERS DISPLA 
wate cata 


OVERALL LINE PRINTER Gram OCcESS 
| Re ACTIVITY DISPLAY 


FREE AREA 
HISTOGRAM 
DISPLAY 


F 





Figure 10-1. Tables Context 


This context is accessed by entering "#T' whenever OPT/3000 is accepting Control Operation Commands. 
There are two displays and a menu of commands available in this context. They are: 


(?) Menu of Commands - System Tables Context 
(D) Detailed Table Information Display 
(R) Table Utilization Report Display (default) 
When the System Table Context is entered, you are prompted for the initial display with: 
ENTER COMMAND FOR DISPLAY (? FOR MENU) 
If you enter an unprogrammed command (or a RETURN), the default display (R) is generated. 


By entering a question mark (?) you can obtain a menu screen giving you the display options within this 
context and all the Display Control commands. This is illustrated in Figure 10-2. 
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muune MENU OF COMMANDS -~- SYSTEM TABLES 






##*DISPLAYS#«# #* CONTROL 
D DETAILED TABLE INFORMATION DISPLAY #A ALTER LINE DRA 





. #C ENTER CPU-MEMORY MANAGER CONTEXT 
R TABLE UTILIZATION REPORT (default) #G ENTER GLOBAL CONTEXT 
#H CONTINUOUS HARD COPY GENERATION 





#**"OTHER TABLES CONTEXT. COMMANDS##* } ENTER I/O CONTEXT 


#L CLOSE LISTING FILE 
#M ENTER MEMORY CONTEXT 
P ENTER PROCESS CONTEXT 
SUSPEND OPT (UNTIL USER INPUT) 
ENTER SYSTEM TABLES CONTEXT 
'f MENU OF CONTROL OPERATION COMMANDS 


€ CLEAR OBSERVED MAXIMUMS COMMAND | 


« KEEP CURRENT TABLE DISPLAY 








€ EXIT 
4 HELP 
L LISTING (GENERATE HARD COPY) 

T TIME CHANGE (OF UPDATE INTERVAL) 
X DEFINE XEQ SEQUENCE 
i MPE COMMAND 

@ MENU DISPLAY 

§ NOTE COMMAND 





Figure 10-2. Menu of Commands - System Tables Display Context 


OPT/3000 generates the prompt: 
COMMANDS ? 


Responding to the menu prompt with an unprogrammed command (or a (RETURN)) generates this context’s 
default display. 
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System Tables Context (#T) 


TABLE UTILIZATION REPORT DISPLAY (R) 


This display provides information about current and maximum utilizations of various system tables, 
queues, and data structures. The Table Report Utilization Display is the default display within this con- 
text and displays table information in the form of bars. It provides less detail than does the Detailed 
Table Information Display. To access this display, enter "R' from anywhere within the System Tables 
Context whenever OPT/3000 is accepting commands. 


TABLE UTILIZATION REPORT i . | | 9:29 AM 
10 20 30 40 50 60 70 80 90 100% 


CODESEGMENT TABLE? 22 
EXTENDED CST... ? 
DATA SEGMENT TABLE f200 000 ee Seed 
PROCESS TABLE uc -feorc) Le 
I/O QUEUE TABLE 8 = 
DISC REQUEST TABLE 288 pce 
TERMINAL BUFFERS 
ATP TERM BUFFERS 
SYSTEM BUFFERS 
SWAP TABLE 
CST BLOCK TABLE . 





















VIRTUAL MEMORY AND 
SPOOLER SPACE ARE IN 
TERMS OF DISC SECTORS. 
ALL OTHER ITEMS ARE IN 
TERMS OF THE NUMBER OF 
ENTRIES IN USE. 


ENTER: 

0 FOR DETAILED INFORMATION 
(includes configured size and 
entry size of each table 
listed above.) 

K KEEP CURRENT TABLE DISPLAY 





(observed maximum 
for some items. ) 


Figure 10-3. Table Utilization Report 


Display Description 


Each system table or data structure is represented in the display by one line. The line shows the current 
utilization with the dark portion of the bar and the maximum utilization with the white portion of the 
bar. If no white portion is present, the current utilization is the maximum utilization. All utilization 
percentages are rounded to the nearest two percent. A (!) is used to delimit the end of the dark portion of 
the bar. 


For most of the items listed, the maximum utilization is the maximum since the last system start-up. This 
information is not always available, so the stated value sometimes is the maximum observed by 
OPT/ 3000. 


The tables are spread over two displays, displayed in alternating fashion. The K command is a toggle. The 


first time you enter K, the current set of tables is kept in display. The next time you enter K, the next set 
of tables are displayed. 
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System Tables Context (#T) 


Interpretation Guidelines 


e 


Any item with a maximum utilization that is low (less than 30 percent) may be configured too large. 


Any item with a maximum utilization that is high (greater than 90 percent) may be configured too 
small. 


Current utilization of the Interrupt Control Stack is always zero. 


The detailed table information Display can help determine the amount of memory that will be saved 
or used if the conf igured size of a table is changed. 


Tables which consistently have low utilizations could probably be configured to be smaller, resulting 
in additional available memory. Peak loads must be considered before reconfiguration. 


Tables which have high utilizations may be causing poor performance. Configuring these tables to be 
larger may improve system performance. 


Legend 


The following is the list of tables included in this display: 

* Code Segment Table (CST) 

* Code Segment Table Extension (CSTX) 

* Data Segment Table (DST) 

* Process Control Block Table (PCB) 

* I/O Queue Table (I0Q) 

* Disc Request Table (DRQ) 

* Terminal Buffers (TBUF) 

* ATP Terminal Buffers (ATPBUF) 

* System Buffers (SBUF) 
Interrupt Control Stack (ICS) 
CST Block Table (CSTBLK) 
Swap Table (SWAPTAB) 
Job Process Count Table | (JPCNT) 

* Virtual Memory Disc Table | (VMEM) 
Spooler Disc Space (SPOOL) 
Primary Message Table (PMT) 
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Secondary Message Table 
Special Request Table 
UCOP Request Queue 
Breakpoint Table 

* Timer Request List 


RIN Table 


System Tables Context (#T) 


(SMT) 
(SRT) 
(UCOPQ) 
(BPT) 
(TRL) 


(RIN) 


As mentioned, an asterisk (*) preceding the table name means the reported maximum is for the time since 


the last system startup. 
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System Tables Context (#T) 
DETAILED TABLE INFORMATION DISPLAY (D) 


This display provides detailed information about system tables and data structures, including the con- 
figured size of each table, the entry size for each, and the current and maximum table utilizations. To ac- 
cess this display, enter "D" from anywhere within the Tables Context whenever OPT/3000 is accepting 
commands. 


DETAILED TABLE INFORMATION. DISPLAY 9:10 AM 
CONFIGURED CURRENT USAGE MAXIMUM USAGE . ENTRY 
ENTRIES IN USE UTIL OBSVD IN USE UTIL SIZE 

CODE SEGMENT TABLE 383 229 59.8% 229 229 59.8% 4 W 

EXTENDED CST 1536 254 16.5% 254 330 21.5% 4 W 

DATA SEGMENT TABLE 1023 422 41.3% 422 666 65.1% 4 W 

PROCESS TABLE 256 64 25.0% 64 101 39.5% 21 W 

I/O QUEUE TABLE 255 29 11.4% 29 70 27.5% 12 W 

DISC REQUEST TABLE 825 11 1.3% 11 171 20.7% 17 W 
TERMINAL BUFFERS #*** Table is not accessible from this system #**## 

ATP TERM BUFFERS 317 13 4.1% 13 40 12.6% 69 W 

SYSTEM BUFFERS 40 0 . 0% 0 3 7.5% 129 W 

SWAP TABLE 2051 334 16.3% 334 334 16.3% 6 W 

CST BLOCK TABLE 72 26 36.1% 26 27 37.5% 1 W 







MAX IN USE INDICATES A “HIGH WATER’ MARK 
MAX OBSVD IS HIGHEST “CURRENT IN USE’ 
SINCE THE TABLES CONTEXT WAS ENTERED 


Figure 10-4. Detailed Table Information Display 
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Display Description 


System Tables Context (#T) 


The tables detailed in this display are documented in the LEGEND section. For each table, one line of in- 


formation is reported as follows: 


CONFIGURED ENTRIES 


CURRENT USAGE IN USE 
UTIL 
MAXIMUM USAGE OBSVD 
IN USE 
UTIL 
ENTRY SIZE 


interpretation Guidelines 


Number of configured entries in the table; reported 
in words, bytes, or sectors (See ENTRY SIZE below). 


Number of entries currently in use. 
Current table utilization (%). 


Maximum number of entries in use observed by 
OPT/3000 while in the System Tables Context. 


- Maximum number of entries in use since last system 


startup for most items; high water mark as observed 
by OPT/3000 for the others. See list of tables in 
next section to determine which is reported for each 
item. 


Maximum in use table utilization (%).: 


Entry size in words (W), bytes (B), or disc sectors (S). 


The number of configured entries reported for the CST,DST, PCB, Swap table and Special Request table in 
OPT differ from those values reported by SYSDUMP. The reasons for the differences are attributed to 
table headers and entries required by the Operating System. OPT reports the number of entries con- 
figured by the user plus those configured by the operating system. SYSDUMP reports only entries con- 


figured by the user. 
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System Tables Context (#T) 
ADDITIONAL COMMANDS 


In addition to the displays, two additional commands are available in this context. 


Keep Current Tables Command (K) 


This command is a toggle that controls the table display. The first time you enter the K command, you 
"keep" the display for the current set of tables and prevent display of the next set of tables. The second 
time you enter the K command, you cause the next set of table to be displayed. 


Clear Maximums Display Command (C) 


This command clears the observed maximum number of entries in use for all tables in the Detailed Table 
Information Display. To invoke this command, enter "C" from either display in the Tables Context. After 
the command is entered, the totals are cleared and the message: 





is displayed. OPT/3000 then pauses, erases the message, and updates the current display. 
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LIST OF OPT/3000 COMMANDS 7 





CONTROL OPERATION COMMANDS 


#2 Menu Display for Control Operation Commands 
To Enter New Context 


#C CPU-Memory Manager Context 

#G Global Context (defaults to Global Report) 
#I I/O Context 

#M Memory Context 

#P Process Context 

#T Systems Tables Context 

#A Alter line drawing character set position 
#H Continuous hard copy generation toggle 
#L Close listing file 

#S Temporarily suspend display updating | 


DISPLAY CONTROL COMMANDS 


Exit 

Access on-line HELP facility 

Hard copy list of current display 

Change update time interval 

Define sequence of commands 

Menu display command for current context 
Execute MPE Commands 

{ Generate note 


ceo MK Am rTM 


BATCH ACCESS CONTROL 


Defaults: 
Minutes between summary reports? (60) 
Reports between closing of report file? (8) 
File closings before termination? (3) 
Name of log file? (none) 
Summary report identification? (none) 


CONTEXTS 


ADDITIONAL 
COMMANDS 

#C CPU/Memory Manager Context Commands 
Displays: ? CPU Context Menu 

C CPU Usage 

M Memory Management Activity 

R CPU-Memory Management Report 

(default) 

#G Global Context Commands 
Displays: ? Global Context Menu 

G Global Resource Usage Report AS RZ 

. (default) 

P Process Summary ASR Z 
Additional A Activate summary report generation 
Commands: R Generate single summary report 

S Stop summary report generation 

Z Zero totals 
#1 1/0 Context Commands 
Displays: ? I/O Context Menu 

D Disc Activity ANQ 

M Magnetic Tape Activity AN 

P Line Printer Activity AN 

R I/O Activity Report (default) 
Additional A Alter Displayed Devices 
Commands: Q Display Disc Queue Information 

N Display Next Device 


#M Memory Context Commands 
Displays: Memory Context Menu 

Bank Contents 

Code Segment Size Histogram 
Data Segment Size Histogram 
Free Area Size Histogram 
Memory Contents 

Overall Histograms 

Memory Report (default) 
Stack Segment Size Histogram 


ADMDdZzNVO Ww 


Additional 
Commands: 


All Segments 

Non-user Segments Only 
Present Segments Only (default) 
User Segments Only 

Keep Current Memory Block 


ACVvVA YP 


#P Process Context Commands 


Process Context Menu 
Program File Display 
Process Display 

Process State Report 
Program File Users Display 
User Summary (default) 


Displays: 


QCD Vv Ns 


Additional 
Commands: 


In Use Only 

Next 

List Working Set Segments 

List SIR Information 

List All Processes in User Summary 
List CPU Active Processes Only 
Paging ON/OFF 

List Stack Markers 

List by User Account 


O0ZWOQO YNZ Ze 


#T System Tables Context Commands 


Displays: ? System Tables Context Menu 
D Detailed Table Information 
R Table Utilization Report Display 
(default) 


ADDITIONAL 


NNANnNDNnAMN 


OO 


AA 


~ COMMANDS 


uv U 
cc 


PU 


PU 


Additional 
Commands: 


Cc 
K 


Clear Observed Maximums 
Keep Current Table Display 


APPENDIX 





DESCRIPTION OF OPT/3000 LOG FILE 


Description of OPT/3000 LOG FILE 


On the following pages the format of the OPT disc log file is described. The file is a binary, fixed length 
record file, and is created with a file code of 1130. The size of the records will depend upon the number 
of discs, line printers, and magnetic tape drives on the system being monitored. Once the file is opened, 
the intrinsic FGETINFO can be used to determine the record size.. The first record of the file is the header 
record, and includes the time and date at which summary report generation was activated. This record 
also includes the number of discs, line printers, and tape drives on the system, as well as the logical device 
number for each such device. The number of discs, line printers, and tape drives must be used in order to 
correctly unpack the information in the remaining summary records. 


The remaining records in the file are the summary records. Each record includes the summary report 
number, time and date for the start of the summary interval, and all of the summary information used to 
generate the line printer summary report. One word of the summary record is used as a flag to indicate 
the last summary record in the file. This summary record must be treated differently, since it is actually 
a summary of all of the previous summary records in the file. 


Description of OPT/3000 Log File 


12 


13 


14 


15 


16 


17 


20 


21 


22 


FORMAT OF RECORD 0 (HEADER RECORD) 


REMAINDER OF THIS 
RECORD 

CONSISTS OF ZEROS 

UNTIL LAST 5 WORDS 


10 
11 


12 


16 
17 


18 
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FORMAT OF RECORDS I-N (SUMMARY RECORDS) 


0 | | SUMMARY REPORT NUMBER | 0 
 Ctetatetatatatatetatatetatatetetetate fslataded selatatatetatatatatetatatehetetatatatr | 
1 |. TRUE: THIS IS OVERALL REPORT | 1 
[Pee Seereeee renee eeesoes eas Sl ads alge | 
2 | (UNUSED) | 2 
 Seetattetetetatatetetiat ata atta atetatod attra tettattaad her atatatatatate | 
3. | DATE FROM "CALENDAR" INTRINSIC | 3 
(a A kl a aa | 
4 | CLOCK TIME FOR START OF INTERVAL | 4 
| OBTAINED FROM "CLOCK" INTRINSIC | 
5 | | 5 
 Ketetetebatatetatatedatatetetatatatatetatetatatatatatatatnatatatatatatatataatatatate | 
6 | ELAPSED TIME FOR THE INTERVAL | 6 
| (MILLISECONDS) | 
7 | | 7 
 detetetetatatetatatetatetatatatatatatatatatatatatatetatatateattetatetatatatatatenatate | 
10 | TOTAL CPU BUSY TIME | 8 
| (MILLISECONDS) | 
ee | | 9 
 Ketetetateatetetatenetahetetaatatetetatatatata atatatetetantateatatatatatetetatetate | 
12 | TOTAL TIME PAUSED FOR DISC & SWAP | 10 
| , (MILLISECONDS) | 
13. | . | 41 
 Rolatatetateteatatastedattehekatatetetatatetatatetatatatatatetatatatetetetatetetatette | 
14 | TOTAL TIME PAUSED FOR DISC | 42 
| (MILLISECONDS) | 
15 | | 13 
 Ketetetetetareetatatatatonetetanetehetatatetatatetatatetetaicdabetsensetateieiateians _—_ 
16 | TOTAL TIME PAUSED FOR SWAP | 14 
| (MILLISECONDS ) | | 
17 «| | 415 
 Ketetatetatatetatatetatetetatatatateteneteiatatetaatetaansehenstsietensaietaialans | 
20 | ‘TOTAL TIME PAUSED BECAUSE IDLE | 16 
| (MILLISECONDS ) | 
21 | | 17 
; | ------- ~~ ee ee ee en ee nee e- | 
22 | TOTAL CPU ON GARBAGE COLLECTION | 18 
| (MILLISECONDS ) | 
23.—Ci«| | 19 
| SSC Swe Soe Sete ooo selec see phere a See 
24 | TOTAL CPU ON MEMORY ALLOCATION | 20 
| (MILLISECONDS ) | 
25 {| 21 
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26 
27 
30 
31 
32 
33 
34 
35 
36 


37 


40 


41 


42 


43 


44 


45 


46 


47 


50 


52 


52 


53 


54 


55 


we we ee me we me we om oe om om oe oe oe oe ee om oe oe ae a me om we oe om oe ae me ae ae a oe ae mw ow ow ow om ow ow 


TOTAL CPU ON USER CACHE MANAGEMENT 
(MILLISECONDS ) 


TOTAL CPU SPENT ON ICS CACHE 
MANAGEMENT (MILLISECONDS) 


oa om om ae oe om oF oe @ a OF om om oo om oe UD aD om ae oy Ge oe om o> ae ae ae om = ae em a ow oe @ oe > oe oe oe oe 


TOTAL CPU SPEND ON CACHE MEMORY 
ALLOCATION (MILLISECONDS) 


ee ee oe ow ee ae me oe we em ae oe om oe om oe me ee ae a om ee om oe om we me me ow em me me ee me om ow ow oe oe 


# TIMES GARBAGE COLLECTION 
ATTEMPTED (BACKGROUND) 
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22 
23 
240 
25 


26 


28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 


45 
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sé | | 46 
| # PROCESS PREEMPTIONS | 

St | | 47 
[Seer ce seeece steer ose SS ase eee eases | 

60 | | 48 
| # CODE SEGMENTS RELEASED. | | 

61 | | | 49 
Gare Seas ais Pee ogame Rane ces apes ang | 

62 | =# DATAS SEGMENTS RELEASED | 50 
| | 

63 | | 51 
[oe ee eae aahs sued area tees t pe reede ase | 

64 | | 52 
| | # = MEMORY MANAGEMENT DISC READS | 

65 | | 53 
a ah ee al hs | 

66 | | 54 
| # MEMORY MANAGEMENT DISC WRITES | 

67 | | 55 
a a a a asa aa aac | 

70 (| | 56 
| # MEMORY MANAGEMENT SPECIAL REQUESTS | 

71. | | 57 
[See Sse ere ese eee Seep tee Sees ese eee sacss | 

72 «| | 58 
| # MEMORY ALLOCATIONS | 

73 «| | 59 
| ------- enn n nn nnn enn nnn nner anna nee ne | 

74 | | 60 
| # MEMORY MANAGEMENT CLOCK CYCLES | 

75 | | 61 
[ Aen See sense sre resn ese K nese ree ses anne seas | 

76 «| | | 62 
| # DISC CACHE DOMAIN RELEASES | 

77 | | 63 

eget | eid at eh Be a a Na tee nN BS FL aD oe a | z Sn? 

100 | | 64 
|  # OF MEMORY ALLOCATION ATTEMPT RESULTS | 

101 | SUMMARIZED IN THE FOLLOWING 5 COUNTS | 65 

| ~---------+----- ~~ + oe 

102 | | 66 
| | # MEMORY ALLOCATION ATTEMPS RESULTING | 

103 | IN SEGMENT RECOVERIES | 67 
a ae a a a re | 

104 | | 68 
{| # MEMORY ALLOCATION ATTEMPTS 

105 | RESULTING IN USE OF FREE SPACE | 69 
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106 
107 
110 
111 
112 
113 
114 
115 
116 
117 
120 
121 
122 
123 
124 
125 
126 
127 
130 
131 
132 
133 
134 


135 


# MEMORY ALLOCATION ATTEMPTS RESULTING 
IN THE MAKING OF OVERLAY CANDIDATES 


# MEMORY ALLOCATION ATTEMPTS 
RESULTING IN GIVE-UPS 


# MEMORY ALLOCATION ATTEMPTS RESULTING 
IN SUCCESSFUL HARD REQUESTS 


(UNUSED) 
hing 
aay 
a “Man 
hon: ante 


— = oe we ee ee am em om ce om ae om am Oe om am oe oe ae ae om oe oe ow ow Be oe om oe ue ae ow Be oe em me ae em om ee oe 


70 


71 


72 


73 


74 


75 


76 


ct 


78 


79 


80 


81 


82 


83 


84 


85 


Disc Device 
Information 


86 


87 


88 


89 


90 


91 


92 


93 
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136 | en l 94 
| # DISC CACHE WRITES (ALL DISCS) | 
1397 | | | 95 
| nnn == nanan nnnen ene nnnnn ccc eeenece ccc | 
140 | 7 | 96 
| DISC QUEUE LENGTH=0 (ALL DISCS) | 
141, | | 97 
| ----nn anne enn en enn c eee c een ccceneeceeeeees | 
142 | 7 | | 98 
| DISC QUEUE LENGTH=1 (ALL DISCS) | 
143 | | 99 
| o--nen enn n anne nee cnn nce nene ne eene cen | 
144 | | 100 
| DISC QUEUE LENGTH=2 (ALL DISCS) | 
145 | | 101 
| [ecenee ce ee ence ene n eens ee nc nner ccceeseceeeee | 
146 | | 102 
| DISC QUEUE LENGTH=3 (ALL DISCS) | 
147 | . | 103 
| ------nn n-ne nnn nn ncn e nee eeee ccc een ences | 
150 | | 104 
| DISC QUEUE LENGTH=4 (ALL DISCS) | 
151 | | 105 
| -----2 nnn nnn ne nnn nc cence cee eecccceecceee | 
152. | | | 106 
| DISC QUEUE LENGTH=5 (ALL DISCS) | 
153 | | 107 
| ------ nnn en nnn n nnn nnnennene ccc ccc eeeenenss | 
154 | | 108 
| DISC QUEUE LENGTH>=6 (ALL DISCS) | 
155 | | 109 
 deteectereatetereateeteattetatetatattatatatatatatetatatatetetatatatatetatetataatata : | This is 
156 | | 110 | repeated 
| # MM DISC READS (DISC 1-N) | | for each 
| | | disc 
| ow enn nnn nr nnn nnn nner nn nn= | | device 
| | 
| # MM DISC WRITES (DISC 1-N) | 
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| # CONTROL OPERATIONS (DISCS 1-N) | 
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#CONTROL OPERATIONS (ALL LPs) | 


# WRITE OPERATIONS (LP 1-N) | 
| 
ee a ee | 
| 
# CONTROL OPERATIONS (LP 1-N) | 
# READ OPERATIONS (ALL TAPES) 
# WRITE OPERATIONS (ALL TAPES) 


eanxwe maw anwwraenw ewe wn wow wwe ewe nmewewew nw ewe ew eww wwe 
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OPT/3000 FATAL ERRORS 





INCOMPATIBLE VERSION OF MPE FOR THIS OPT 
2 INCOMPATIBLE TERMINAL FOR USE WITH OPT 
3 UNABLE TO ENABLE MPE INSTRUMENTATION 

4 UNABLE TO EXPAND DL AREA 

5 UNABLE TO SAMPLE MPE INSTRUMENTATION 


100 INVALID NUMERIC INPUT 

101 READ FROM $STDIN FAILED (NOT EOF) 
102 UNABLE TO PURGE OLD LOG FILE 

103 UNABLE TO OPEN SPECIFIED LOG FILE 


200 OPEN OF FILE “OPTREPT’ FAILED 

201 UNABLE TO WRITE TO OPT LOG FILE 

202 UNABLE TO OBTAIN EXTRA DATA SEGMENT 
203 UNABLE TO WRITE TO EXTRA DATA SEGMENT 
204 UNABLE TO READ FROM EXTRA DATA SEGMENT 


Errors 100-103 are applicable only to the batch execution of OPT. 
Errors 200-204 are associated with the generation of summary reports. 


UNABLE TO OPEN #STDINX - this message appears when OPT/3000 is unable to open the file #SDTINX, 
along with the file system error number. 


INVALID DATA! - this message appears in place of the percentage bars in the case of system data corrup- 
tion or corruption of data from the measurement interface. OPT/3000 continues execution. If you 
receive this message, contact the Response Center. 
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EXAMPLE BATCH JOB FOR OPT/3000 = 





JOB optbatch,manager. sys;restart;OUTCLASS=epoc, 2 
(RUN OPT. PUB.SYS . 

30 

4 

3 

optlog 

Example batch stream job for OPT. 

IEOJ 


A 


Activate Summary Report Generation Command 
(A), 5-16, 5-17 

All Segment Histogram Command (A), 7- 25 

Alter Displayed Devices Command (A), 8-13 

Alter LIne Drawing Character Set Position 

Command (#A), 3-13 

ATP Terminal Buffers (ATPBUF), 10-4 


Banks Contents Display (B), 7-10, 7-13 
Batch Job, example of, D-1 

Batch Mode, 2-6 

BIO (Blocked I/O) flag, 9-13, 9-18, 9-20 
Breakpoint Table (BPT), 10-5 


Cc 


Clear Maximums Display Command (C), 10-8 
Close Listing File Command (#L), 3-14 
Code Segment Size Histogram Display (C), 
7-16, 7-17, 7-26 
Code Segment Table (CST), 10-4 
Code Segment Table Extension (CSTX), 10-4 
Context Commands, 4-1 
Context Concept, 2-4 
Contexts 
In OPT/3000, 4-1 
Entering, 3-15, 3-16 
Continuous Hard Copy Command (#H), 3-13 
Control Operation Commands (#), 3-10, 3-16 
CPU/Memory Management Context (#C), 6-1, 
6-12 
Menu of commands, 6-2 
CPU-Memory Management Report Display (R) 
6-3, 6-6 
CPU State Descriptions, 6-5 
CPU-Memory Manager Context Command (#C) 
3-15 
CPU Usage Display (C), 6-7, 6-9 
CST Block Table, 10-4 


Data Segment Size Histogram Display (D), 
7-18, 7-19, 7-27 
Data Segment Table (DST), 10-4 
Detailed Table Information Display (D), 
10-8 
Detailed Table Information Display 
Additional Commands, 10-8 © 
Clear Maximums Display Command (C), 10-8 
Keep Current Tables Command (K), 10-8 
Disc Request Table (DRQ), 10-4 
Display All Active Process Command (A), 9-6 
Display Control Commands, 3-1 thru 3-9 
Display Disc Queue Information Command (Q), 
8-14 
Display Next Devices Command (N), 8-13 
Display Only CPU Active Processes Command (C), 
9-6 
Display Only Processes in Specified User Account 
Command (D), 9-6 


Enter Global Context Command (#G), 3-15 
Enter I/O Context Command (#1), 3-15 
Enter Memory Context Command (#M), 3-16 
Enter Process Context Command (#P), 3-16 
Errors, list of, C-1 

Exit Command (E), 3-2 


FA (Father Wait) flag, 9-13, 9-18, 9-20 
Free Area Histogram Display (F), 7-22, 7-24 
Free Area Histogram Additional Commands 
All Segment Histogram (A), 7-25 
Keep Current Memory Block (K), 7-25 
Non-User Segment Only Histogram (N), 
7-25 
Present Segment Histogram (P), 7-25 
User Segment Only Histogram (U), 
7-25 


I-1 


INDEX (Continued) 





G 


Generate Single Summary Report (R), 5-1 8, 5-19 
Global Context (#G), 5-1, 5-2 
Menu of commands, 5-2 
Global Resource Usage Report Display (G), 5-3, 
5-5 | 
GRIN (Global RIN) flag, 9-13, 9-17, 9-20 


H. 


HELP Command (H), 3-2, 3-4 


IMP (Impeded) flag, 9-13, 9-18, 9-20 
In Use Only Command (I), 9-22 
Interactive Access, 2-7 
Interrupt Control Stack (ICS), 10-4 
I/O Activity Report Display (R), 8-3, 8-7 
I/O Context (#1), 8-1, 8-14 
Menu of Commands, 8-2 
I/O Queue Table (IOQ), 10-4 
I/O (Unblocked I/O) flag, 9-13, 9-18, 9-20 


Job Process Count Table (JPCNT), 10-4 
Junk (Junk Wait) flag, 9-13, 9-18, 9-20 


K 


Keep Current Memory Block (K), 7-25 
Keep Current Tables Command (K), 10-8 


Line Printer Activity Display (P), 8-11, 8-14 
Line Printer Activity Display 
Additional Commands, 8-13 
Alter Displayed Devices Command (A), 
8-13 
Display Disc Queue Information 
Command (Q), 8-14 
Display Next Devices Command (N), 
8-13 
List of OPT/3000 Commands, A-1 
Batch Access Control 
Control Operation Commands #?, A-1 
Contexts, A-2 . 
#C CPU/Memory Manager Context 
Commands, A-2 
#G Global Context Commands, A-2 
#11/O Context Commands, A-2 
#M Memory Context Commands, . 
A-3 
#P Process Context Commands A-3 
#T System Tables Context 
Commands, A-3 
List Working Set Segments Command (W), 
9-23, 9-25 
Listing Command (L), 3-4, 3-5 
Log File, B-1/B-10 
LRIN (Local RIN) flag, 9-13, 9-17, 9-20 


M 


Magnetic Tape Activity Display (M), 8-8, 8-10 
MAIL (Mail Wait) flag, 9-13, 9-18, 9-20 
MEM (Memory Wait) flag, 9-13, 9-18, 9-21 
Memory Contents Display, 7-6, 7-7, 7-8, 7-9 
Memory Context (#M), 7-1 thru 7-27 
Menu of Commands, 7-2 
Memory Management Activity Display (M), 6-10, 
6-11, 6-12 
Memory Report Display (R), 7-3, 7-4, 7-5 
Menu of Control Operation Commands (#?), 3-12 
Menu Display Command (?), 3-8 | 
MPE Command (:), 3-8 
MRNG (Mourning Wait) flag, 9-13, 9-17, 9-20 
MSG (Message Wait) flag, 9-13, 9-18, 9-20 
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INDEX (Continued) 


N 


Next Command (N), 9-23 
Non-User Segment Only Histogram (N), 7-25 
Note Command (!), 3-9 


O 


OPT/3000 Commands 
Command Syntax, 2-4 
Error Messages, C-1 
Features, 1-1 
How to Terminate, 2-8 
Line Printer Use, 2-2 
List of Commands, A-1, A-2, A-3 
Operating System Requirements, 2-2 
Recoverability, 2-3 
Specifications for Running, 2-1 
Terminals Supported, 2-1 
Overall Histogram Display (O), 7-11, 7-14, 7-15 


Paging On Command (B), 9-6 
PARM Values, 2-7 
Present Segment Histogram (P), 7-25 
Primary Message Table, 10-4 
Process Context (#P), 9-1 thru 9-25 
Menu of Commands, 9-2 
Process Control Block Table (PCB), 10-4 
Process Display (P), 9-14, 9-15, 9-16, 9-17, 9-18 
Program File Display (F), 9-7, 9-8 
Program File User’s Display (U), 9-9, 9-10, 9-11, 
9-12, 9-13 
Process State Report Display, 9-19, 9-20, 9-21 
Process State Report Display Additional 
Commands, 9-22 
In Use Only Command (I), 9-22 
List Working Set Segments 
Command (W), 9-23 
Next Command (N), 9-23 
Process Summary Display (P), 5-6 thru 5-19 


RIN Table (RIN), 10-5 


Secondary Message Table (AMMT), 10-5 

Security Restrictions for Process Context, 9-3, 9-4 

SIR (SIR Wait) flag, 9-13, 9-18, 9-20 

SON (Son Wait) flag, 9-13, 9-18, 9-20 

Special Request Table (SRT), 10-5 

Spooler Disc Space (SPOOL), 10-4 

Stack Segment Histogram Display (S), 7-20, 7-21, 
7-27 

Status Flags 
Description of, 9-12, 9-13, 9-17, 9-18, 9-20, 
9-21 . 

Stop Summary Report Generation (S), 5-18 

Summary Report, 5-9 thru 5-15 

Suspend Command (AS), 3-14 

System Buffers (SBUF), 10-4 

System Tables Context (#T), 10-1 thru 10-8 
Menu of Commands, 10-2 

Swap Table, 10-4 


T 


Table Utilization Report Display (R), 10-3, 10-4, 
10-5 

Terminal Buffers (TBUF), 10-4 

Time Change Command (T), 3-5 

TIME (Timer Wait) flag, 9-13, 9-18, 9-20 

Timer Request List (TRL), 10-5 

TOUT (Timeout Wait) flag, 9-13, 9-18, 9-21 


INDEX (Continued) 





U xX 
UCOP (UCOP Wait) flag, 9-13, 9-18, 9-20 
UCOP Request Queue (UCOPQ), 10-5 
User Segment Only Histogram (U), 7-25 XEQ Command, 3-6, 3-7 
User Summary Report (G), 9-5, 9-6 . 


Z 
Vv 


Zero Totals Command (Z), 5-19 
Virtual Memory Disc Table (VMEM), 10-4 
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